home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / jdrbbs08.zip / DOCS_ETC.ZIP / DOCS_1.DOC < prev    next >
Text File  |  1993-04-06  |  258KB  |  4,590 lines
  1.  
  2.                                   JDR_BBS .08
  3.                                       by
  4.                                   John Rohner
  5.  
  6.      Well,   you  have  taken  the time  to  download  JDR_BBS.    Probably 
  7.      wondering:   what  have I gotten?   First and foremost,   it is a  BBS 
  8.      program.  A BBS program for the future. 
  9.  
  10.      Completely  original  programming.    Many new and  unique  ideas  and 
  11.      methods.    Unlimited expansion and growth potential.    Incorporating 
  12.      much  in  itself  that other programs rely on  3rd-party  software  to 
  13.      accomplish. 
  14.  
  15.      I have tried, and will continue to try, to incorporate the best of all 
  16.      the BBS programs into this software. 
  17.  
  18.      If you are  the  "artistic"  type,  or a programmer,  this software is 
  19.      definitely for you.  It has been designed to take maximum advantage of 
  20.      your creativity. 
  21.  
  22.      The interface is FAST!   Logging on and doing things are all optimized 
  23.      in  the interface.   Hot-key menu action on all things are  the  norm.  
  24.      There are not a hundred little "Would you like..."  questions.   Sure, 
  25.      all the commands are  there--but unobtrusive,  out of the way of those 
  26.      who do not want,  or need,  them.   If it can make life easier on  the 
  27.      sysop or user, it tries to do so. 
  28.  
  29.      The  software is balanced.   Users and sysops have many options,   and 
  30.      much power, at their control. 
  31.  
  32.      Enough, let the adventure begin...
  33.  
  34.  
  35. CONTENTS        Line  Topic
  36.                 ────  ───────────────────────────────────────────────────────
  37.                  147  NOTICE
  38.                  182  LIMITS
  39.                  210  REGISTRATION
  40.                  307  DISCLAIMER
  41.                  317  ACCESS
  42.                  343  WHAT'S IN A NAME?
  43.                  365  STARTING UP
  44.                  429  TRY OUT
  45.                  528  RESTARTING
  46.                  589    Ram Drive
  47.                  643    Config
  48.                  680  INPUTING
  49.                  808    Colorizing
  50.                  842    Censoring
  51.                  916    Active spelling checker
  52.                  932  OUTPUTTING
  53.                  995  CONSOLE KEYS
  54.                  997    When waiting for a caller
  55.                 1033    From the terminal program
  56.                 1050    When a user is on-line
  57.                 1129    Definable
  58.                 1167    Misc.
  59.                 1209  LOGGING
  60.                 1214    Callers log
  61.                 1260    Session log
  62.                 1265    Chat log
  63.                 1269    Error log
  64.                 1278  LOGIN
  65.                 1326  READING MESSAGES
  66.                 1348    Header
  67.                 1371    Body
  68.                 1378    Command Line
  69.                 1393      Again
  70.                 1395      Continue message
  71.                 1404      Delete
  72.                 1412      Edit
  73.                 1434      Forward
  74.                 1455      Get files
  75.                 1467      Give files
  76.                 1484      Next
  77.                 1488      Previous
  78.                 1494      Reply
  79.                 1497      View a file attach
  80.                 1515      User maintenance
  81.                 1522      Sysop DB
  82.                 1531      / AI's Go Fish
  83.                 1542      ? Peer Review
  84.                 1559      ! Re-Locate
  85.                 1568      @ Header Edit
  86.                 1576      ^ Re-Inform
  87.                 1589    Misc.
  88.                 1603  ENTERING MESSAGES
  89.                 1620    Heading Line
  90.                 1627    In
  91.                 1634    To
  92.                 1658    Subject
  93.                 1672    At
  94.                 1694    Line numbers
  95.                 1702    Quote original
  96.                 1712    Carbon Copies
  97.                 1722    Upload message
  98.                 1759    File Attaches
  99.                 1802    Body
  100.                 1877    Command Line
  101.                 1888      %
  102.                 1896      Abort
  103.                 1898      Continue entering
  104.                 1901      Delete lines
  105.                 1904      Edit
  106.                 1910      Finish later
  107.                 1934      Grammar check
  108.                 1946      Insert lines
  109.                 1952      List
  110.                 1960      Preview
  111.                 1969      Save
  112.                 1972  MESSAGE FILES
  113.                 2072  RAMBLINGS
  114.                 2109  FILE AREA CONTENTS LISTING
  115.                 2134    Standard
  116.                 2178    Point & Shoot File Selection and Information System
  117.                 2240    Paged File System
  118.                 2331  DOWNLOADING
  119.                 2453  UPLOADING
  120.                 2501    Searching
  121.                 2548    File Descriptions
  122.                 2586  REMOVING FILES
  123.                 2648  MISC.
  124.                 2675  I AM LOST!?!
  125.                 2704  CUSTOMIZING 101
  126.                 2727  TOGGLES
  127.                 3058  SETTINGS
  128.                 3679  PATHNAMES
  129.                 4340  CONVERSION
  130.                 4367  MODEM SETUP
  131.                 4452    Problems
  132.                 4489  TERMINAL PROGRAM
  133.                 4583  SPECIAL THANKS
  134.                 4588  NEXT
  135.  
  136.                 Line  numbers are useful for such file viewing  utilities  as 
  137.                 LIST.    This documentation is not really meant to be printed 
  138.                 out.    I,  myself,  never print documentation out--I  prefer 
  139.                 instead to read it with PC-Write,  that way I can delete  the 
  140.                 stuff I already know, or consider unimportant. 
  141.  
  142.                 DOCS_1.DOC describes how to use the software.
  143.                 DOCS_2.DOC describes how to set up and configure a BBS.
  144.                 MENUCMDS.DOC describe the command system and commands.
  145.      
  146.  
  147. NOTICE          This is not a pre-release, alpha, or beta version.  I will be 
  148.                 numbering my releases .01  to .99.   Each release will always 
  149.                 have a couple of bugs,  or enhancements that are awaiting the 
  150.                 future.   I will never consider this software finished.  Bugs 
  151.                 that do appear, however,  can usually be gotten around by the 
  152.                 software's great redundancy. 
  153.  
  154.                 I  make  a great effort each release to test  everything  for 
  155.                 bugs.  But there is no such thing as bug-free software.  With 
  156.                 each release a program approaches that goal. 
  157.                 
  158.                 New versions will be released every 1 to 6 months.   It is an 
  159.                 evolving product.   In many cases,  the ideas you relay to me 
  160.                 will appear in the very next release. 
  161.  
  162.                 If  you find any thing not to your liking,  please  tell  me.  
  163.                 New  ideas need not change the old method,  this  program  is 
  164.                 designed to do many same things differently. 
  165.                 
  166.                 The key word is "release"--there are no intermediary,  alpha, 
  167.                 or  beta versions.   Some releases may only have a couple  of 
  168.                 important bug fixes, others may include 100k of new stuff. 
  169.  
  170.                 I  am  basically  using  the same  distribution  and  release 
  171.                 techniques Chuck Forsberg uses with his DSZ product. 
  172.  
  173.                 All registered sysops are notified, by computer mail to their 
  174.                 BBS, of a new release--so you will never have to wonder about 
  175.                 whether you have still got the latest version. 
  176.  
  177.                 It is  ready to run now,  just INSTALL it and run it--even if 
  178.                 you are running a BBS on COM1,  do not worry,  it will be  in 
  179.                 local mode. 
  180.  
  181.  
  182. LIMITS          Mostly  your  RAM  and drive space  are  your  only  limiting 
  183.                 factors, and if you can program, there are no limits. 
  184.  
  185.                 999 file areas.
  186.  
  187.                 100 voting questions.
  188.  
  189.                 999 message areas.
  190.  
  191.                 32,767 active messages per message area.
  192.  
  193.                 Message numbers can go to 2,100,000,000. 
  194.  
  195.                 25 of your own defined data bases.
  196.  
  197.                 32,767 door programs.
  198.  
  199.                 99 undergoing-peer-review users.
  200.  
  201.                 At least 999 message files.
  202.  
  203.                 32,767 entries in the databases.
  204.  
  205.                 20000+ active users.
  206.  
  207.                 20000+ active files on-line.
  208.                 
  209.                 
  210. REGISTRATION    Required within 30 days of use.
  211.  
  212.                 See ORDER.FRM for pricing information.
  213.  
  214.                 Registration entitles you to use JDR_BBS for three years. 
  215.  
  216.                 If you are a company,  you must do a corporate  registration.  
  217.                 If  you  are  an  individual,  you  may  choose  personal  or 
  218.                 corporate registration. 
  219.  
  220.                 Registration is on a per node basis.   Each computer  running 
  221.                 this  software  must  be  registered.    A   single  computer 
  222.                 multitasking three phone lines is considered one computer. 
  223.  
  224.                 I have tried to make registration as flexible as possible for 
  225.                 everyone.    A  computer expert will probably not need  stuff 
  226.                 like  voice  support  or updates,  but  a  corporation  would 
  227.                 probably  find it quite useful.   Rather than  spreading  the 
  228.                 cost among everyone,  I  broke the various extras out of  the 
  229.                 primary registration package. 
  230.  
  231.                 Upon  registration,  you will receive a packet containing  at 
  232.                 least the following: 
  233.                   ∙ 1   720k  disk,  or 2 360k  disks, containing the  latest 
  234.                     registered files. 
  235.                   ∙ A  3 key sequence which you'll be able to use to  extract 
  236.                     the registered  files  from JDR_BBS.REG when new versions 
  237.                     come out. 
  238.                   ∙ Confirmation of payment or order.
  239.                   ∙ An account on the Immortality BBS (development site).
  240.                   ∙ Access to the encrypted Registered JDR_BBS net mail  echo 
  241.                     for technical support. 
  242.                   ∙ A  message sent to your BBS informing you when  each  new 
  243.                     release is available. 
  244.                   ∙ An entry  in  the list  of  registered  BBS's,  which  is 
  245.                     included with JDR_BBS.
  246.                   ∙ The   registered  version  has  additional  features  and 
  247.                     commands. 
  248.  
  249.                 Registration is only for three years.   This was done because 
  250.                 the  registration fee is not near the value of the  program--
  251.                 but I felt a need to keep it affordable.   Also because of my 
  252.                 continuous-update distribution method (which means you do not 
  253.                 pay for each major release like most software.) 
  254.  
  255.                 The  disks I send you only contain the additional  registered 
  256.                 files,   they  do  not contain the  complete  program.    The 
  257.                 complete  program  would require adding another $10   to  the 
  258.                 registration,   which  would be unnecessary since the  latest 
  259.                 version is always on various BBS's. 
  260.  
  261.                 The most weird thing about my registration cost structure  is 
  262.                 the  $10/month  voice support.   It is structured  like  this 
  263.                 because,   frankly,   support is the  greatest  cost  besides 
  264.                 development.    Rather than spread the cost over everyone,  I 
  265.                 have  set  it so only those who need it will get it.    Also, 
  266.                 since  I  will  be doing the support,  you  will  get  expert 
  267.                 knowledge.
  268.                 
  269.                 The  printed documentation contains no more information  than 
  270.                 the  disk-based documentation,  but may be  more  convenient.  
  271.                 The updates are replacement pages containing what has changed 
  272.                 between releases, keeping old documentation always current. 
  273.  
  274.                 The phone costs to download future releases can be  excessive 
  275.                 if you are in a remote area.   For this reason, I  am willing 
  276.                 to send complete releases of JDR_BBS by mail at the following 
  277.                 rates:  $15 for U.S. addresses,  $20  for Canadian addresses, 
  278.                 and $30  for addresses outside U.S. or Canada.  You may order 
  279.                 the  latest  release,   or pre-order for  the  next  release.  
  280.                 Please specify diskette type. 
  281.  
  282.                 The  code is complex enough,  that it is cheaper to  register 
  283.                 and ask me your confusing questions,  than to spend literally 
  284.                 days or weeks figuring  it out for yourself.   The Registered 
  285.                 JDR_BBS net mail echo is the only way, besides voice,  to get 
  286.                 specific detailed  answers  from me to any  problems  you are 
  287.                 having with JDR_BBS. 
  288.  
  289.                 The prices will not change significantly in the future.  Even 
  290.                 as  the  program  becomes more  advanced  and  more  graphics 
  291.                 oriented.   The prices will, for the most part, only increase 
  292.                 at the rate of inflation (2 to 5% a year). 
  293.  
  294.                 By  1995  I  expect to only need about one release every  six 
  295.                 months. 
  296.  
  297. │               There  will never be a non-shareware version.   Although  for 
  298. │               cost reasons I may reduce posting of the source to only a few 
  299. │               major BBS's around the country. 
  300.  
  301.                 Usually sending cash is safe.  For extra safety, you can send 
  302.                 it via certified mail. 
  303.                 
  304.                 See also: REGISTERED PACKAGE
  305.  
  306.  
  307. DISCLAIMER      I  make  no warranties of  any  kind,   either  expressed  or 
  308.                 implied, as to the fitness of use, quality, or performance of 
  309.                 this software. 
  310.  
  311.                 In  no manner shall I be held liable or responsible  for  any 
  312.                 losses or damages arising from the use of this software. 
  313.  
  314.                 See also:  NOT_DOCS.DOC
  315.  
  316.  
  317. ACCESS          I can be reached as follows:
  318.  
  319.                 Physical mail:    John Rohner
  320.                                   POB 340304
  321.                                   Milw., WI 53215
  322.  
  323.                 Electonic mail:   John Rohner
  324.  
  325.                                   Immortality
  326.                                   (414) 643-1576
  327.  
  328.                                   Exec-PC
  329.                                   (414) 789-4352
  330.  
  331.                 Net mail:         Immortality
  332.                                   (414) 643-1576
  333.                                   Must be direct call.
  334.                                   JDR_BBS continuously accepts mail (anytime
  335.                                   before a user name is accepted--at the logo
  336.                                   or login ANSI, or user name question).
  337.  
  338.                 Contact me if you have any problems with the software.   I am 
  339.                 willing to generate special bug-fixed JDRBBS.EXE's for you if 
  340.                 you are willing to test that the bug is eliminated. 
  341.  
  342.  
  343. WHAT'S IN A     JDR_BBS is the name of this software, always has been.
  344. NAME?
  345.                 Starting  with .08  I  decided it would be nice to give it  a 
  346.                 "word" name--not just initials.  That name is Juggernaut. 
  347.  
  348.                 The full name became: Juggernaut, Dendro-Recominant BBS 
  349.  
  350.                 The first question is always, "What does 'Dendro-Recombinant' 
  351.                 mean?" 
  352.  
  353.                 "Dendr-"  means tree-like.   The BBS and its environments are 
  354.                 all tree-like. 
  355.  
  356.                 "Recombinant"   means recombined.   This software  recombines 
  357.                 features  into  one .EXE that many other programs have  in  a 
  358.                 hundred other .EXE's. 
  359.  
  360.                 So,   when referring to this software,  you should use either 
  361.                 JDR_BBS  or  Juggernaut--whichever  you  feel  less   foolish 
  362.                 saying. 
  363.  
  364.  
  365. STARTING UP     To  make  full  use of this  software,   you  will  need  the 
  366.                 following (listed in order of importance): 
  367.                    ∙ The latest version of PKZip/PKUnZip.
  368.                    ∙ Your favorite text editor.
  369.                    ∙ A fossil driver, such as X00 or BNU.
  370.                    ∙ A protocol driver, such as DSZ or GSZ.
  371.                    ∙ An ANSI editor, such as The Draw.
  372.                    ∙ The latest version of ARJ.
  373.                    ∙ The latest version of LHA.
  374.                    ∙ Any version of List and SortF.
  375.                    ∙ You will probably also want the latest version of PKLite 
  376.                      or similar (for reducing .EXE's). 
  377.                    ∙ The Latest version of BiModem.
  378.                    ∙ A disk defragmenting utility.
  379.                    ∙ You will probably also want Microsoft Basic PDS 7.x.
  380.                      (Only needed if you want to do source modifications.)
  381.                    ∙ You  will  probably also want Microsoft Macro  Assembler 
  382.                      5.1+.   (Only  needed  if  you  want  to do source level 
  383.                      modifications.) 
  384.  
  385.                    ∙ A  640k  or  more  computer.   Should  work  on  any  PC 
  386.                      compatible. 
  387.  
  388.                    ∙ A 2400 baud or better modem.
  389.                 
  390.                    ∙ No  graphics  (yet)  so any  monitor  should  be  fine--
  391.                      although a color monitor is really necessary to see ANSI 
  392.                      color screens.   But once the BBS is set up the way  you 
  393.                      want it, a monochrome monitor will do just fine. 
  394.  
  395.                    ∙ One or more hard disks.  At least 30 megs if operating a 
  396.                      multi-user  BBS or a floppy for just a node between  two 
  397.                      friends. 
  398.  
  399.                 Except for Basic PDS,  and MASM, all of the above software is 
  400.                 available  for  download  from most  every  BBS.    Most  you 
  401.                 probably  already have.   If you are just beginning to  learn 
  402.                 about all this,  then X00,  SortF,  and The Draw are probably 
  403.                 the  least familiar.   They are usually stored on BBS's  with 
  404.                 the  following file names:  X00Vxxx.ZIP,  SORTFxxx.ZIP,   and 
  405.                 TDRAWxxx.ZIP--where "xxx" is the version number. 
  406.  
  407.                 If  you cannot find any of the software on your local  BBS's, 
  408.                 then give mine a call and you can download it from there. 
  409.  
  410.                 In  the future I will be porting the program over  to  Visual 
  411.                 Basic and Windows as well. 
  412.  
  413.                 The  software  has  been tested  with  SuperStor  2.0   drive 
  414.                 compression software.   It works fine,  but with a  dedicated 
  415.                 computer  as  your  BBS,   the  disadvantages  outweigh   the 
  416.                 advantages.    The  disadvantages:  slow  file  moves,   more 
  417.                 uncertainty about testing programs (doors and uploads),   and 
  418.                 limited  disk enhancement utilities that can be run on  their 
  419.                 own  as events.   The advantages:  more drive space for  door 
  420.                 programs.   But the advantage is not true.   PKLite your door 
  421.                 .EXE's and you will do better.  Why?  Because doors have lots 
  422.                 of  little  data  files--and  the  minimum  file  size   with 
  423.                 SuperStor is 8192 bytes (each file/dir uses at least that). 
  424.  
  425.                 I  have  been told the software works fine with DesqView  and 
  426.                 Windows, but I have not personally tried it out. 
  427.                 
  428.  
  429. TRY OUT         Just  run  JDRBBS.EXE.   It is configured with comm port =  0 
  430.                 (local/console)  so you do not have to worry about hooking up 
  431.                 a modem/etc. to try it immediately.   It will use the current 
  432.                 drive as its basis drive,   and  will initialize the #NEWUSER 
  433.                 new user record (the first user record). 
  434.  
  435.                 The software keys on the existence of PATHS.DAT to  determine 
  436.                 when   you  first  run  it.    It  then  creates   PATHS.DAT, 
  437.                 BBS001.BAT,  DOOR001.BAT,  and BACKUP.BAT.   It also sets the 
  438.                 comm  port  to zero,  re-initialize's #NEWUSER to the default 
  439.                 settings,  and  sets the waiting-for-caller drives-to-show to 
  440.                 the  current drive.   Finally, it goes through all your small 
  441.                 SYSTEM\*.DAT files and changes "C:\" to whatever your current 
  442.                 drive is,  and  similarly for BLOCKS.TXT.   It does the  same 
  443.                 change for all occurances of "System Operator"  with whatever 
  444.                 name  you  give  it.    That is all.    Which  means  if  you 
  445.                 accidentally  delete PATHS.DAT,  you do not have to fear  for 
  446.                 the rest of your files. 
  447.  
  448.                 Because  it is set for local-only operation (Comm port  = 0), 
  449.                 it will automatically  display  the logo and start  the login 
  450.                 process.   Follow what it says.  It is just like logging onto 
  451.                 a normal BBS. 
  452.  
  453.                 Logon with your name.
  454.  
  455.                 One  thing  you  will notice immediately is that  instead  of 
  456.                 "password:" I use "verification:".   You can change it if you 
  457.                 like.   "Password"  was just too archaic for me.   After all, 
  458.                 "my pass word",  "]I[ %5^&890", and "643-1576" are all valid, 
  459.                 and hardly a word. 
  460.  
  461.                 Now that you are in, play around with it, get to know it. 
  462.  
  463.                 I have pre-created the following for you:
  464.  
  465.                     1 files area: UPLOADS
  466.                     a few message areas
  467.                     2 doors: ED.EXE (PC-Write)
  468.                              CSHOW.EXE (CompuShow)
  469.                     7 voting questions
  470.                     1 ramble
  471.                     8 security levels
  472.                     Some sample MESSAGE.xxx files.
  473.                     3 Directry files: Unprotects
  474.                                       Music Quotes
  475.                                       Other Ansi's
  476.                     Some other minor/sample stuff.
  477.  
  478.                 This is so you can get some general feel for the software and 
  479.                 its capabilities. 
  480.  
  481.                 For the file area related commands,  you might want to put  a 
  482.                 file or two in the uploads area to get a feel for what things 
  483.                 look   like.    If  you  do,   their  descriptions  will   be 
  484.                 "?" until you give them one. 
  485.  
  486.                 If any of you design a much simpler BBS,  send me a  copy  of 
  487.                 your files. I will try to include about 5 different "flavors" 
  488.                 of what can be done in future releases. 
  489.  
  490.                 After looking around, hit <alt>u, then enter your name.  This 
  491.                 is the user maintenance--change your security level to 100. 
  492.                 
  493.                 Hitting "!" at the main menu brings up the sysop menu. 
  494.                 
  495.                 At the sysop menu,  hitting 1, 2, 3, 4, or 5 selects the sub-
  496.                 menu wanted. 
  497.  
  498.                 Bring  up  the  configuration  menu (4).
  499.                 
  500.                 Now you should make sure the .EXE and/or paths are correct in 
  501.                 the following instances:
  502.                   Alter Pathnames
  503.                   Door Maintenance
  504.                   File Areas
  505.                   Protocols
  506.                 
  507.                 Finally,  under Change Settings,  change your Net Address (if 
  508.                 you have one) and your Phone Number to your own.  Then change 
  509.                 Hub  Address (if you are part of FidoNet)  to the Address  of 
  510.                 your local Hub (or the hub of whatever net you use most). 
  511.  
  512.                 Do not worry about the communication parameters for now.
  513.                   
  514.                 You may quit the software by hitting <alt>x.
  515.  
  516.                 In  some cases I mention the menu option (eg.   "New  Stuff") 
  517.                 when  talking about something,  sometimes I mention the  menu 
  518.                 command  (eg.  "NewS"),  and there may even be times  when  I 
  519.                 mention the actual module name (eg.  "NewStuff").  Just stick 
  520.                 with it and remember that they are just names.   I have tried 
  521.                 to use merely descriptive text (eg. "listing of stuff that is 
  522.                 new to the caller") but sometimes I regress. 
  523.  
  524.                 See also:  CUSTOMIZING 101, CUSTOMIZING 201, MODEM SETUP,
  525.                            CONFIG, SETTINGS, PATHNAMES
  526.  
  527.  
  528. │RESTARTING     After the first time, always use "BBS001"  (as in BBS001.BAT) 
  529. │               to  run the BBS.   Or rather BBSxxx where "xxx"  is the  node 
  530. │               number you wish to run.  If using only one node, it is easier 
  531. │               to just copy BBS001.BAT to BBS.BAT and just type "BBS" to run 
  532. │               the program. 
  533.  
  534.                 I have bundled SHROOM with this release to give the  software 
  535.                 swap-to-disk capabilities.   You should unpack the ZIP.  In a 
  536.                 future  version I will use my own swap-to-disk routine.    If 
  537.                 you do not do any "_shrink" door exits, then you need not use 
  538.                 SHROOM. 
  539.  
  540.                 You may use JDRBBS /?  (or BBS001  /?)  to bring up a list of 
  541.                 what "/" command-line commands are available.  They are: 
  542.  
  543.                     /?            to get a help list.
  544.                 
  545.                     /BIOS         to   toggle  usage  of  BIOS/direct  screen 
  546.                                   writing ON and OFF. 
  547.  
  548.                     /NODE=x       to start up node x.  Where "x"  is a number 
  549.                                   from 0 to 999. 
  550.  
  551.                     /PORT=x       to  re-set  the  current comm  port  to  x.  
  552.                                   Where  "x"  is  a  number  from 0 to 4  (or 
  553.                                   higher if your fossil supports it). 
  554.  
  555.                     /MODEM=x      to reset the current comm port's baud  rate 
  556.                                   to x.  "x"  is one of:  1200,  2400,  9600, 
  557.                                   19200, or 38400.   It is the speed at which 
  558.                                   the software talks to the modem. 
  559.  
  560.                     /LOG=x        to change the current LoggingAmount.    See 
  561.                                   SETTINGS.   "x" is one or more digits (0 to 
  562.                                   9) and one or more of "A" to "F" letters. 
  563.  
  564.                     /1STCMD=xxxx  to  re-set  the  first  command  to   xxxx.  
  565.                                   "xxxx"  must be a four letter command.  You 
  566.                                   may run a single command by doing: 
  567.                                     JDRBBS /1STCMD=xxxx
  568.                                     BBS001 /1STCMD=STRT
  569.                                   the first part runs JDRBBS and executes the 
  570.                                   command "xxxx",  the second part re-sets it 
  571.                                   properly.   "xxxx"  should not be a command 
  572.                                   that  requires the user's name  unless  you 
  573.                                   put  a  "LogN"   as the  first  command  in 
  574.                                   "xxxx"'s command list.  Your "xxxx" command 
  575.                                   must be all upper-case (that is, "doAB"  is 
  576.                                   no   good,   must  be  "DOAB").    Probably 
  577.                                   "/MODEM=0" then "/MODEM=n" needs to be done 
  578.                                   for   some  commands--otherwise  it   exits 
  579.                                   because  it does not find a carrier on  the 
  580.                                   currently defined port.. 
  581.  
  582.                 Each  command must have no spaces within it.   So "/node = 1" 
  583.                 will not work, nor will "/log=1 3 567". 
  584.  
  585.                 For the most part,  the /BIOS,  /PORT,  /MODEM,  and  /1STCMD 
  586.                 commands  are  meant  to get yourself out of a jam  when  you 
  587.                 accidentally define them wrong when running the software. 
  588.  
  589. Ram Drive       The system will make extensive use of some files.  For this I 
  590.                 recommend you define a RAM drive. 
  591.  
  592.                 There  are two inter-linked path's that relate to  operations 
  593.                 of  a  RAM drive.   When in "Alter Pathnames",  they are  the 
  594.                 "Files to go to RAM Drive" and "RAM Drive" entries. 
  595.                 
  596.                 For  distribution,   I   have  set the  "RAM  Drive"  path to 
  597.                 d:\BBS\NODE.???\RAMDRIVE (that is,  the same as "Files to  go 
  598.                 to RAM Drive"),   so until you change it to  a real RAM drive 
  599.                 the system will be really dragging.   Since most of the  text 
  600.                 is stored external to the program itself.
  601.                 
  602.                 But  there is no need to do this unless you actually wish  to 
  603.                 use  the  software,  for evaluation purposes only;  it is not 
  604.                 worth the hassle. 
  605.  
  606.                 The reasons  for using a RAM drive are fairly obvious.  Those 
  607.                 files most called will get loaded and sent faster.  This also 
  608.                 reduces wear and tear on the drive itself. 
  609.  
  610.                 The  reasons  for putting text in a RAM drive file is not  so 
  611.                 obvious.   The  quick answer:  Basic has  a limited amount of 
  612.                 string space, text is strings,  putting it in a file frees up 
  613.                 string space.   But there are some other advantages as  well: 
  614.                 the  text is easily modifiable,   internally  the program  is 
  615.                 easier to understand--which  leads  to  improved optimization 
  616.                 with  the remaining code,  a  RAM drive can be put anywhere--
  617.                 regular memory, expanded,  extended, or on disk--allowing for 
  618.                 more  flexibility by keeping the .EXE smaller and the  "real" 
  619.                 RAM used by the program much smaller. 
  620.  
  621.                 Yes,   there is a slow down--not noticeable at 8 MHZ,  trade-
  622.                 offs are a fact of life, and this was one of them. 
  623.  
  624.                 If you have something like: 
  625.                 
  626.                     Files to go to RAM Drive : C:\BBS\NODE.???\RAMDRIVE\
  627.                                    RAM Drive : E:\
  628.                 
  629.                 Then       at      start-up,       every      file       with  
  630.                 "C:\BBS\NODE.???\RAMDRIVE\"  as its path will  be changed  to 
  631.                 "E:\".      This    is   done   internally.     So,     using 
  632.                 "C:\BBS\NODE.???\RAMDRIVE\" is the same as saying the file is 
  633.                 on "E:\", that it is on the RAM drive. 
  634.                 
  635.                 Unless    the   two   fields   contain   the    same    path, 
  636.                 "C:\BBS\NODE.???\RAMDRIVE\"  is never really accessed.  Since 
  637.                 all  the  files are on "E:\",  it is "E:\"   that  is  always 
  638.                 accessed. 
  639.  
  640.                 See also: PATHNAMES
  641.  
  642.  
  643. Config          Below is what my config.sys and autoexec.bat look like:
  644.  
  645.                 CONFIG.SYS:
  646.                 buffers = 25
  647.                 files = 20
  648.                 device = x00.sys B,0,19200 T=4096 R=4096 eliminate
  649.                 device = ramdrive.sys 45
  650.  
  651.                 AUTOEXEC.BAT:
  652.                 set dszlog=c:\bbs\dszlog
  653.                 break off
  654.                 verify off
  655.                 cd \bbs
  656.  
  657. │               The X00 line above defines COM1: with a locked DTE baud rate. 
  658. │               If  you do not need to lock your baud rate (such as with most 
  659. │               baud modems) use: device = x00.sys eliminate 
  660.  
  661. │               The X00 also has "T=4096" for a transmit buffer of 4096 bytes 
  662. │               and  "R=4096"   for a receive buffer of  4096   bytes.    X00 
  663. │               defaults to 512  byte buffers,  but larger buffers are useful 
  664. │               with MNP connects and do speed things up a little. 
  665.                 
  666.                 You may  also use a disk cache--it will help--but  wait until 
  667.                 you  have  the  BBS working as you like  it.    Since  if  it 
  668.                 crashes,   you lose whatever is stored in the  cache.    Also 
  669.                 note,   DSZ recommends you disable your cache before  running 
  670.                 DSZ. 
  671.  
  672. │               Turning "break off" and "verify off" is an old BBS'ers trick, 
  673. │               allowing faster disk accesses.  Not recommended for iffy hard
  674. │               drives.
  675.  
  676.                 If you just want to look around--not run the BBS, just ignore 
  677.                 the CONFIG/AUTOEXEC stuff. 
  678.  
  679.  
  680. INPUTING        In most cases inputing of file names and user  names  utilize 
  681.                 "auto-completion"--you start it, the software finishes it. 
  682.  
  683.                 With every keystroke, when entering a file or user name,  the 
  684.                 software  searches  through all entries and looks to  see  if 
  685.                 there is  only  one possible keystroke for you to  make  next 
  686.                 (when you are  not allowed to type  a filename  that does not 
  687.                 exist,  or users that do not exist).   The software will then 
  688.                 send the keystroke out--saving  the user the need to type it.  
  689.                 Similarly if only one file or user name is possible. 
  690.  
  691.                 When  entering  user names,  matching is not done  until  the 
  692.                 second character.   This is done to speed up  reaction--since 
  693.                 the  first  character  usually has a lot  of  matches.    Not 
  694.                 necessary for file names because they use a different type of 
  695.                 search system (all or nothing for file names, all or whatever 
  696.                 is typed for user names). 
  697.  
  698.                 When entering user names, you may type a "*" or a "?" anytime 
  699.                 after the first character.   When this is detected, a list of 
  700.                 all the users matching those letters will appear.    Example: 
  701.                 typing JOHN* would show all users with names with the first 4 
  702.                 letters  "JOHN".    This is mostly useful for  when  entering 
  703.                 messages  TO  a person in a message area that allows  any  TO 
  704.                 name (thus no auto-name-detect). 
  705.  
  706.                 Some answer fields, that have a size limit,  automatically do 
  707.                 a [Enter] when you reach the end of the field. 
  708.  
  709.                 Phone numbers detect whether it is a local or  long  distance 
  710.                 number (United States/Canada format only, for now).  If users 
  711.                 complain that they cannot enter a number they want,  they are 
  712.                 entering a "1-" number,   or an international number (which I 
  713.                 do not support yet) or a bad phone number. 
  714.  
  715.                 Security levels, in some places, can be entered by entering a 
  716.                 range--either a single value,  or two values separated by the 
  717.                 word "to" (eg. "5 to 20"). 
  718.  
  719.                 In most situations, a [Space] (or [Tab]) will pause the text, 
  720.                 and an [Enter] will cancel or exit an option.
  721.  
  722.                 [Tab],   when reading messages,  will pause the message,  but 
  723.                 when at the reading messages command line, it will act like a 
  724.                 [N]ext  command.   I  did this in response to some complaints 
  725.                 that  users  wanted  the [Enter] key to  act  like  a  [N]ext 
  726.                 command--it seems beginners who cannot touch-type do not like 
  727.                 the idea of searching around for the "N"  key.   With one  of 
  728.                 your most powerful fingers 1/2  inch from the "N" key always, 
  729.                 and with the [Enter] key requiring a weak pinky and 10  times 
  730.                 more  pressure,   I  am not going to make the [Enter]  key  a 
  731.                 [N]ext  key.    That kind of poor design only  increases  the 
  732.                 speed of your getting carpal tunnel syndrome. 
  733.                 
  734.                 For times,  a 24  hour clock is assumed.   This means that an 
  735.                 hour of "0"  is midnight,  "12 is noon.   A day starts at "0" 
  736.                 (midnight) and goes through to "23" (11 pm).   Because of the 
  737.                 way  seconds are stored,  they may be off by one second  from 
  738.                 what  you  entered.   A  00:00:00  to 00:00:00   range  means 
  739.                 available 24  hours (indeed,  any two matching times mean  to 
  740.                 use  the  full 24  hours).   For 24  hour  restriction,   use 
  741.                 00:00:00  to 23:59:59.  You must enter the full 8  characters 
  742.                 (HH:MM:SS) or you will get random results. 
  743.  
  744.                 When entering a description or a message, the following keys, 
  745.                 when typed, will produce the result. 
  746.  
  747.                   Keys       Resulting
  748.                   Entered    Character
  749.                   ───────    ─────────
  750.                     a"a          ä
  751.                     e"e          ë
  752.                     i"i          ï
  753.                     o"o          ö
  754.                     u"u          ü
  755.                     y"y          ÿ
  756.                     A"A          Ä
  757.                     O"O          Ö
  758.                     U"U          Ü
  759.  
  760.                     a`a          à
  761.                     e`e          è
  762.                     i`i          ì
  763.                     o`o          ò
  764.                     u`u          ù
  765.  
  766.                     a'a          á
  767.                     e'e          é
  768.                     i'i          í
  769.                     o'o          ó
  770.                     u'u          ú
  771.                     E'E          É
  772.  
  773.                     a^a          â
  774.                     e^e          ê
  775.                     i^i          î
  776.                     o^o          ô
  777.                     u^u          û
  778.  
  779.                     n~n          ñ
  780.                     N~N          Ñ
  781.  
  782.                     a.a          å
  783.                     A.A          Å
  784.  
  785.                     c,c          ç
  786.                     C,C          Ç
  787.  
  788.                     ?^?          ¿
  789.                     !^!          ¡
  790.  
  791.                 With the exception of the last few commands, you type:
  792.                   1. character you want
  793.                   2. character above the character you want
  794.                   3. character you want
  795.                 The BBS will then delete these three characters  and  replace 
  796.                 them with the foreign character. 
  797.  
  798.                 When a user receives a beep,  such as  during  active grammar 
  799.                 check,  or after file transfers, the console will not get the 
  800.                 beep (to preserve sysop sanity). 
  801.  
  802.                 When  entering  drive paths or pathnames,  you should  always 
  803.                 specify the "d:\" at the beginning. 
  804.  
  805.                 If you are the sysop,  then most of the "inactivity time-out" 
  806.                 timers will be ignored. 
  807.                 
  808. Colorizing      When  entering the body of a message,  or file  descriptions, 
  809.                 you  can  use  special coding to give color to a  word  or  a 
  810.                 phrase. 
  811.  
  812.                 There  are  two codes: " }xword"  and " ]xtext[ ".    In both 
  813.                 cases, the "x" represents a number: 
  814.                      1  Bright blue.
  815.                      2  Bright green.
  816.                      3  Bright red.
  817.                      4  Bright violet.
  818.                      5  Yellow.
  819.                      6  Bright white.
  820.  
  821.                 The  rules:   There must be a space before either the "}"  or 
  822.                 the "]" symbols.  There must be no spaces between the "}"  or 
  823.                 "]"  and "x".   There must be no spaces between "x"  and  the 
  824.                 word or text.   The "[" must come immediately at the end of a 
  825.                 word (no space before it). 
  826.  
  827.                 "}x"   combinations  are  used  to colorize  a  single  word.  
  828.                 Example: " }3Hello }6Johnny.  }1How are you?"  "Hello"  would 
  829.                 appear bright red,  "Johnny." would appear bright white,  and 
  830.                 "How"   would appear bright blue.   "are you?"  would be  the 
  831.                 normal brown if a message, or blue if a description. 
  832.  
  833.                 "]x...[" combinations are used to colorize phrases.  Example: 
  834.                 " ]3Hello Johnny[  ]1How are you?["  "Hello Johnny." would be 
  835.                 bright red, and "How are you?" would be bright blue. 
  836.  
  837.                 Note that the block color method works across message  lines.  
  838.                 This  means  you  can start it on one line,  and  end  it  on 
  839.                 another.    With all text in between becoming whatever  color 
  840.                 you select. 
  841.  
  842. Censoring       This software has the ability to "censor"  user inputed text. 
  843.                 This  censoring is done only when entering file  descriptions 
  844.                 or the body of messages. 
  845.  
  846.                 There   are  three  "levels"   of  censoring:   simple   case 
  847.                 adjustment,    removal   of   non-words,   and   removal   of 
  848.                 superlatives.    All  three  are  done  when  entering   file 
  849.                 descriptions,  and only the first two are done when  entering 
  850.                 messages. 
  851.  
  852.                 Censoring is not done on imported or uploaded messages.    It 
  853.                 is also not done when importing file descriptions. 
  854.  
  855.                 You,   the sysop,  may toggle on/off this feature.   You  may 
  856.                 toggle removal of non-words on/off and you may toggle removal 
  857.                 of superlatives on/off.   If both are toggled off,  then case 
  858.                 adjustment  is also off.   If either one is toggled on,  then 
  859.                 case adjustment is also on. 
  860.  
  861.                 Simple  case adjustment is the "correcting"  of lower case to 
  862.                 upper case.   Examples:  " i " becomes " I ",  "bbs"  becomes 
  863.                 "BBS", ".gif" becomes ".GIF". 
  864.  
  865.                 Removal  of  non-words eliminates the word completely.    The 
  866.                 words that are eliminated:  "alot", "l8tr",  "c00l",  "k00l", 
  867.                 "gotta". 
  868.  
  869.                 Removal  of  superlatives  eliminates  the  word  completely.  
  870.                 Words  that  are  superlatives;  excellent,   great,   super, 
  871.                 incredible, etc. are removed. 
  872.  
  873.                 All  three  are  done  as the user enters  the  text.    Case 
  874.                 adjustment is the only one that is not "demonstrated"  at the 
  875.                 time.  By demonstrated, I mean that when a user enters a non-
  876.                 word in either a message or description,  or a superlative in 
  877.                 a  description,   then they will see the word deleted  before 
  878.                 their  eyes--no matter how many times they  repeatedly  enter 
  879.                 it. 
  880.  
  881.                 Of the above, the "alot" elimination seems to have caused the 
  882.                 most  trouble--those  who  use this  non-word  seem  to  have 
  883.                 trouble stopping themselves. 
  884.  
  885.                 Why  censor superlatives?   If you are an experienced  sysop, 
  886.                 you  know.    Users will always try to add a  superlative  in 
  887.                 their descriptions,   they seem to feel the "need"  to "sell" 
  888.                 the sysop on the upload, this is particularly true of systems 
  889.                 where  the upload must first be validated by the sysop before 
  890.                 others  can download it.   One can get tired of them quickly. 
  891.                 This  is  one of my favorite features of this  software  (the 
  892.                 other being automatic logging of removed files). 
  893.  
  894.                 Description censoring is not done when the user is the sysop. 
  895.                 
  896.                 You  may  add  or  alter the  various  censored  words.    In 
  897.                 SHORT.TXT they are organized as follows: 
  898.  
  899.                 0001 to 0039 Superlatives, must be ordered by size--smallest, 
  900.                              then increasing in size.   Words are censored if 
  901.                              their  first  x characters match  one  of  these 
  902.                              words. 
  903.                 0040 to 0049 Are  "non-words".   Words are censored if  their 
  904.                              first  x  characters match one  of  these words.  
  905.                              For  positions where numbers may appear,  use  a 
  906.                              space. 
  907.                 0050 to 0064 These are "to be upper cased"  phrases.   If the 
  908.                              last (or right)  x  characters of the word being 
  909.                              checked  contains these characters,  than  these 
  910.                              characters  will be replaced with  their  upper-
  911.                              cased version.  Example: "dsz.com is not a gif." 
  912.                              would  become  "dsz.COM is not a gif."    ".com" 
  913.                              matched  the right side of the  word  "dsz.com", 
  914.                              but "gif" did not match the right side of "gif." 
  915.  
  916. Active          Active spell checking is a form of censoring.  While entering 
  917. spelling        messages,   it  beeps whenever a word you just typed  is  not 
  918. checker         found  in  the word lists.   It beeps at the same  misspelled 
  919.                 words that Grammar Check would highlight. 
  920.  
  921.                 If  both  removal  of  non-words  censoring  and  removal  of 
  922.                 superlatives censoring are turned off,  active spell checking 
  923.                 will  not operate.   If you do not want censoring,  but  want 
  924.                 active spell checking,  then leave one of the censors toggled 
  925.                 ON,  and clear  out the SHORT.TXT entries for it (so it finds 
  926.                 nothing to censor). 
  927.  
  928.                 Active  spell checking can be turned on and off by the  user, 
  929.                 but it still requires that you have censoring ON to work. 
  930.  
  931.  
  932. OUTPUTTING      There  are  a  couple  of ways for BBS  programs  to  display 
  933.                 output. 
  934.  
  935.                 One  is to display everything to the local (console)   screen 
  936.                 first,   then  send it on to the remote screen all  at  once.  
  937.                 This is the fastest method,  but it does not allow output  to 
  938.                 be interrupted (such as for hot-keys).    Either this  method 
  939.                 is  common,   or  a  lot of BBS programs  do  not  handle  it 
  940.                 properly.   When using the terminal program in this software, 
  941.                 it  has special coding to defeat these poorly designed  BBS's 
  942.                 by not wasting time displaying all the extra text. 
  943.  
  944.                 Another method is to display everything to the local  screen, 
  945.                 then  send it to the remote screen and watch for input  after 
  946.                 each character.   This has the disadvantage that sending  and 
  947.                 waiting each character is slow. 
  948.  
  949.                 Another method is to output fixed length packets to the local 
  950.                 screen  and remote screen,  checking for incoming keys  after 
  951.                 each send.  This is good, but... 
  952.  
  953.                 Another  method--that  I  use--is to output  variable  length 
  954.                 packets to the local and remote screen, checking for incoming 
  955.                 keys after each send.   I  use the ASCII 27  code (ANSI  code 
  956.                 signal) as the "packet breaker upper". 
  957.  
  958.                 Besides the last method, there are times when I also output a 
  959.                 character  at a time and check after that.   This is done for 
  960.                 the "SendTT" text, in which lines may only have ANSI codes at 
  961.                 the start, and do not require a lot of speed anyways. 
  962.  
  963.                 I  also  add a farther delay:  character pacing.    The  next 
  964.                 character  or  packet to send is not sent until the  fossil's 
  965.                 output buffer is empty (signifying that the character(s) have 
  966.                 been sent).  If I did not do this, then the modem or fossil's 
  967.                 buffers  would put us right back at square one--fast  massive 
  968.                 output, with no input character checking. 
  969.  
  970.                 Similarly  for  actually  displaying characters,   there  are 
  971.                 multiple methods: 
  972.  
  973.                 The slowest method is to use the screen writing routines that 
  974.                 came with the language itself. 
  975.  
  976.                 The  safest  method is to write assembly routines that  route 
  977.                 characters  directly  to INT 21h (DOS functions)  to  do  the 
  978.                 displaying.  This is the non-BIOS method I use. 
  979.  
  980.                 A  more  risky,   but faster,  method is  to  write  assembly 
  981.                 routines  that  route characters directly to  INT  10h  (BIOS 
  982.                 functions) to do the displaying. 
  983.  
  984.                 The fastest, but most limited, method is to write directly to 
  985.                 the screen's memory itself.   This is known as "direct screen 
  986.                 writing".   I  use this, and some INT 10h calls,  for my BIOS 
  987.                 screen writing option.   It has the disadvantage that it does 
  988.                 not work in graphic screen modes (such as multi-window modes, 
  989.                 etc.)   But for normal 80x25 screen modes,  it is the best to 
  990.                 use. 
  991.  
  992.                 See also:  SETTINGS, TERMINAL PROGRAM
  993.  
  994.  
  995. CONSOLE KEYS
  996.  
  997. When waiting    +          to view the next help page.
  998. for a caller    -          to view the previous help page.
  999.                 <f1>       toggles the trapping of all comm I/O to a file.
  1000.                 <f2>       toggles the trapping of all chat to a file.
  1001.                 <f3>       toggles whether you are available to chat.
  1002.                 <f5>       toggles the drive space/memory info pages.
  1003.                 <f6>       toggles screen blanking.
  1004.                 <f7>       toggle between help screens and sysop info.
  1005.                 <f9>       to logon locally.
  1006.                 <up>       to view the previous callers log page.
  1007.                 <down>     to view the next callers log page.
  1008.                 <pgdn>     toggles the trapping of all comm I/O to a file.
  1009.                 <alt>a     to  alter  the  system  settings.    "ASet"   menu 
  1010.                            command. 
  1011.                 <alt>d     to use the terminal program.   Whatever  you type, 
  1012.                            an "AT"  will put tacked onto the front of it, and 
  1013.                            the  command  sent  to  the  modem.    After  your 
  1014.                            "session", whether it be just sending a command to 
  1015.                            the modem or a session on another BBS,   you  will 
  1016.                            need  to hit any key to continue,  as  the  system 
  1017.                            pauses so  you are able to see the results of what 
  1018.                            you did.  See also: TERMINAL PROGRAM 
  1019.                 <alt>f     to do file maintenance.  "File" menu command.
  1020.                 <alt>p     modem   command   line  interface.    Useful   for 
  1021.                            debugging   modem   problems.    Just   like   any 
  1022.                            communications program modem command line.  Can be 
  1023.                            used to dial out,  <alt>p again to exit this mode, 
  1024.                            <pgup> to  upload  a file,  <pgdn>  to download  a 
  1025.                            file, <alt>s to shell to DOS. 
  1026.                 <alt>r     to remove a file.  "RemF" menu command.
  1027.                 <alt>s     to shell to DOS.
  1028.                 <alt>t     to  change  the toggle  settings.    "Togs"   menu 
  1029.                            command. 
  1030.                 <alt>u     to do user maintenance.  "User" menu command.
  1031.                 <alt>x     to exit to DOS.
  1032.                 
  1033. From the        <f1>       toggles the trapping of all comm I/O to a file.
  1034. terminal        <f2>       Send a file (ASCII send--no protocols).    Can use 
  1035. program                    wildcards  to  send a random file from a bunch  of 
  1036.                            files.  No stop/exit key handling is done. 
  1037.                 <pgup>     to send a file.  Upload to the BBS you called.
  1038.                 <pgdn>     to  receive  a file.   Download from the  BBS  you 
  1039.                            called. 
  1040.                 <end>      to transmit any netmail meant for that BBS.    You 
  1041.                            must  have  dialed  with a "d string"  command for 
  1042.                            this to work. 
  1043.                 <alt>h     to hang up.
  1044.                 <alt>s     to shell to DOS.
  1045.                 <c><left>  <control><left> This will send an ASCII 27.  It is 
  1046.                            expected  that you will follow up this key with  a 
  1047.                            valid   ANSI   string--none  of  which   will   be 
  1048.                            displayed. 
  1049.  
  1050. When a user     <f1>       toggles the trapping of all comm I/O to a file.
  1051. is on-line      <f2>       toggles the trapping of all chat to a file.
  1052.                 <f3>       toggles whether you are available to chat.
  1053.                 <f5>       toggles sysop-on-next status.
  1054.                 <f6>       toggles screen blanking.
  1055.                 <up>       to increase their session time by 5 minutes.
  1056.                 <down>     to decrease their session time by 5 minutes.
  1057.                 <left>     to decrease their SL by one level.
  1058.                 <right>    to increase their SL by one level.
  1059.                 <pgup>     Send a file (ASCII send--no  protocols).   Can use 
  1060.                            wildcards  to send a random file from a  bunch  of 
  1061.                            files.  No stop/exit key handling is done. 
  1062.                 <pgdn>     toggles the trapping of all comm I/O to a file.
  1063.                 <esc><esc> hang up on the user.
  1064.                            Hitting  a  single  <esc>  waits for you  to  type 
  1065.                            another  key--even if the user hangs up (they  can 
  1066.                            no  longer type keys).   After hitting one  <esc>, 
  1067.                            any key besides <esc>  will "unstick"  the waiting 
  1068.                            of keys and everything will be normal. 
  1069.                 <alt>b     to beep the user.
  1070.                 <alt>c     to chat with the user.
  1071.                            Hit <esc> and then c to exit chat.
  1072.                 <alt>h     hang up on the user.
  1073.                 <alt>p     modem command line interface.  See above.
  1074.                 <alt>s     to shell to DOS.  Output is not sent to the user.
  1075.                 <alt>u     to do user maintenance.  "User" menu command.  The 
  1076.                            caller  does  NOT see anything,  and any keys  the 
  1077.                            caller types are executed after you exit the  user 
  1078.                            editor.    You  can  make changes to  the  current 
  1079.                            caller,  or any caller,  and those changes will be 
  1080.                            immediate. 
  1081.                 <alt>x     to  do an immediate exit to DOS.   This  does  not 
  1082.                            save anything.   It only works when you are logged 
  1083.                            on at the console. 
  1084.                 <c><left>  <control><left>   This  will insert  an  ASCII  27 
  1085.                            (arrow)   into  what  you  are  editing  (such  as 
  1086.                            message,   message title,  etc.).   You must  then 
  1087.                            continue with "[" and then a valid ANSI sequence--
  1088.                            none  of  which will be shown,  but it  will  take 
  1089.                            effect and is stored.   Example:  <ctrl><left>[37m 
  1090.                            is the ANSI sequence "" which is white color. 
  1091.  
  1092.                 <up>,  <down>,  <left>,  <right>  are session only  commands, 
  1093.                 their effects are not permanent.  If the user is logged in at 
  1094.                 the console, they will not be able to do this, these keys are 
  1095.                 then used to move around places. 
  1096.  
  1097.                 <alt>s  and  <alt>c  will interrupt what is  currently  being 
  1098.                 done,  and either shell to DOS or enter chat mode. When done, 
  1099.                 you  may need to hit return to redraw the screen--if you  did 
  1100.                 the commands while a  menu was being displayed.   Usually you 
  1101.                 will  not  want  to hit these keys at anywhere  else  besides 
  1102.                 menus  because it can cause confusion--both for you  and  the 
  1103.                 user--especially if you do it while they are about to enter a 
  1104.                 file  description.   The key to remember:  that  wherever you 
  1105.                 interrupt the user,  the <enter>  you type will be handled as 
  1106.                 if the user typed it. 
  1107.  
  1108.                 Increasing  the  SL allows you to do sysop  things  from  the 
  1109.                 console while another user is on-line.  It also allows you do 
  1110.                 demonstrate the sysop capabilities to another user. 
  1111.  
  1112.                 When adding or subtracting time, you are actually subtracting 
  1113.                 or adding,  respectively,  to their "elapsed time used today" 
  1114.                 total.   The changes are not permanent.   A   negative number 
  1115.                 will show up in their user profile for "time  elapsed" if you 
  1116.                 gave them more time than their daily limit.  Since total time 
  1117.                 available  is  calculated  by  subtracting elapsed time  from 
  1118.                 daily allowances. 
  1119.  
  1120.                 When  you are in a DOS shell (such as using <alt>s--which can 
  1121.                 be used from Chat as well), two useful commands are: "DSZ rz" 
  1122.                 and  "DSZ  sz filename.ext".   The first receives  files  the 
  1123.                 person  at  the other end is sending,  and the  second  sends 
  1124.                 "filename.ext".  Both assume comm port 1, and you may need to 
  1125.                 change to the directory with DSZ first. 
  1126.                 
  1127.                 See also:  THE "WHO'S ON" STATUS LINE
  1128.  
  1129. Definable       You  may define <ctrl>F1  to <ctrl>F10.   Lines 0851  to 0860 
  1130.                 in SHORT.TXT correspond to F1 to F10, respectively. 
  1131.  
  1132.                 These  lines should contain a 4 letter menu command that  you 
  1133.                 wish to use. 
  1134.  
  1135.                 These control sequences will be allowed from anywhere.
  1136.  
  1137.                 This is an extremely powerful,  dangerous,  and unpredictable 
  1138.                 ability  of  the software.   It relies on you to know when  a 
  1139.                 menu  command should or should not be executed--especially so 
  1140.                 when a user is on-line. 
  1141.  
  1142.                 They are probably best used to call a door from the  waiting-
  1143.                 for-caller screen (hint hint). 
  1144.  
  1145.                 Because you may enter any menu command, and do the command at 
  1146.                 any time,  you can see how problems can arise.   Particularly 
  1147.                 important to not do:  user commands when no user is there for 
  1148.                 the software to find or update. 
  1149.  
  1150.                 Only  trial-and-error will let you know when to use that  key 
  1151.                 to  do  what  you  want,  and when not to  (ie,   the  system 
  1152.                 crashes). 
  1153.  
  1154.                 I have predefined <control>F1 as the door to ED.EXE.
  1155.  
  1156.                 I  have  predefined <control>F2  as the MCED command.    Very 
  1157.                 useful when you design yourself into a hole in your menus. 
  1158.  
  1159.                 Some commands probably will not work if the current comm port 
  1160.                 is  not zero (because the software does not detect a  carrier 
  1161.                 signal  on  the current port).   I  will fix this in .09   by 
  1162.                 creating a menu command "PORT _xxx" which switches to another 
  1163.                 port (such as 0 which means local). 
  1164.                 
  1165.                 See also:  MENU COMMANDS
  1166.  
  1167. Misc.           The  way  the program works is like a hub  and  spoke  system 
  1168.                 (such  as  a  large city in relation to  the  smaller  cities 
  1169.                 around it). 
  1170.  
  1171.                 Menus represent the central hub.   From these you go to  many 
  1172.                 sub commands. 
  1173.  
  1174.                 This  means that most commands are sub commands and not  part 
  1175.                 of the main hub. 
  1176.  
  1177.                 So,  for safety's sake,  you should only execute console keys 
  1178.                 (such as chat, or <ctrl>Fx's) from the menus when a caller is 
  1179.                 on-line. 
  1180.  
  1181.                 The  concept is that you can go to the sub commands from  the 
  1182.                 main hub,   but you should not jump from sub command  to  sub 
  1183.                 command directly. 
  1184.  
  1185.                 For  you  programmers:   even  though  Basic  has  re-entrant 
  1186.                 capabilities,   exploiting  them by jumping from  sub  to sub 
  1187.                 without going  through  the  central  hub (Dispatcher)  could 
  1188.                 conflict with the global variables and distort them. 
  1189.  
  1190.                 The  "dinky"   stuff,  such as <esc><esc>  or  beeping,   you 
  1191.                 should not worry about.  It is the chatting, shelling to DOS, 
  1192.                 running a door,  etc.  that are likely to cause troubles  for 
  1193.                 you if you execute these "inside" a sub module. 
  1194.  
  1195.                 You can do a <pgup>  "send them a file"  while a menu ANSI is 
  1196.                 being  displayed.   After your file is sent,  the entire menu 
  1197.                 ANSI is  re-drawn.    It's an example of  Basic's  re-entrant 
  1198.                 ability--since  both displaying the file and key-checking  is 
  1199.                 handled  by  the  same routines  for  both  options.     When 
  1200.                 displaying  the ANSI it calls a checking routine--which finds 
  1201.                 that you want to send a file,  it then calls the file display 
  1202.                 routine  (which is the same routine that did the key checking 
  1203.                 originally)   to display the file (it will then call the  key 
  1204.                 checking  routine  also).    As  you see,   it  can  be  very 
  1205.                 recursive--I  hate  recursion and consider it risky,  but  it 
  1206.                 does seem to work ok. 
  1207.  
  1208.  
  1209. LOGGING         Both  the  Callers log and the Errors log can be  limited  in 
  1210.                 what they show using the setting for "LoggingAmount". 
  1211.  
  1212.                 See also:  SETTINGS
  1213.                 
  1214. Callers log     This has the file name CALLERS.LOG.
  1215.  
  1216.                 The callers log contains 3 types of data lines:  user,  file, 
  1217.                 and system. 
  1218.  
  1219.                 The  system  lines  all  start  with  a  "|=",   and  contain 
  1220.                 informational  messages  from the BBS to the  sysop.    Users 
  1221.                 cannot see these lines. 
  1222.  
  1223.                 The  user lines begin with the date and a user's name.    For 
  1224.                 all users to see, it is mostly who logged on when. 
  1225.  
  1226.                 The  file lines come straight out of the protocol log  files.  
  1227.                 They do have any paths stripped out before being added. 
  1228.  
  1229.                 When listing the log,  users are shown the user lines and the 
  1230.                 file  lines.   When the sysop lists the log,  he is shown all 
  1231.                 lines. 
  1232.  
  1233.                 From the information shown, users can deduce the following:
  1234.                   ∙ Who called, when, and from where.
  1235.                   ∙ Who upload files--in case they would like to contact  the 
  1236.                     uploader with a question. 
  1237.                   ∙ Who  downloaded files--to see if a  friend  downloaded  a 
  1238.                     file  (saving them the trouble)  or to see what  kind  of 
  1239.                     download interest their own uploads have gotten. 
  1240.                   ∙ Who lost credit for duplicate/bad uploads.
  1241.                   ∙ Who passed, or failed, Peer Review.
  1242.  
  1243.                 It is also useful for other sysops, they can see who are good 
  1244.                 users and who are  bad  users.   Perhaps leading to increased 
  1245.                 access for these good users on their own board. 
  1246.  
  1247.                 File  attach  transfers are logged with see-able or not  see-
  1248.                 able  lines  depending  on  how  that  file's  file  area  is 
  1249.                 configured. 
  1250.  
  1251.                 Note  that  when  you list the log  using  an  external  list 
  1252.                 utility,  that the user who did the actions comes after  what 
  1253.                 they did.   That is, when using something like LIST, the user 
  1254.                 that did a file transfer is listed after those file  transfer 
  1255.                 entries.   The file should be read bottom-up.  When using one 
  1256.                 of the software's internal log lister's,  this is taken  into 
  1257.                 account  and is listed correctly with the person's name first 
  1258.                 and their actions on the following lines. 
  1259.  
  1260. Session log     This has the file name SESSION.LOG.
  1261.  
  1262.                 Contains the I/O exactly as it was  sent--including  all  the 
  1263.                 ANSI or Avatar codes. 
  1264.  
  1265. Chat log        This has the file name CHAT.LOG.
  1266.  
  1267.                 Contains the trapped chat sessions.
  1268.  
  1269. Error log       This has the file name ERRORS.LOG.
  1270.  
  1271.                 This  log contains important error messages,  or  unimportant 
  1272.                 minor adjustment notices.
  1273.  
  1274.                 When you have a problem,  you should check here first to  see 
  1275.                 if it might have helpful information. 
  1276.                 
  1277.                 
  1278. LOGIN           When  logging  in,  a  caller may start their name with  "=". 
  1279.                 Example, "=John Rohner".  What "=" does is disable auto-name-
  1280.                 detection.   This is useful for users that use scripts, since 
  1281.                 with  auto-name-detection their "key sequence"  that makes up 
  1282.                 their  name,  may change from login to login if a  similarly-
  1283.                 named user is added, or deleted, from the user list. 
  1284.  
  1285.                 Auto-name-detection  at logon always gives me a good chuckle.  
  1286.                 This occurs when a new user calls the second time,  and types 
  1287.                 their  name,  with the software producing half of it.    They 
  1288.                 just  pause,  and you feel the disbelief they are undergoing, 
  1289.                 "How the heck did the BBS know that...". 
  1290.  
  1291.                 If  the caller just hits [Enter] for their name,  then  auto-
  1292.                 name-detect  is immediately turned off (without bothering  to 
  1293.                 tell the caller). 
  1294.  
  1295.                 If the caller just hits [Enter] for their password, and it is 
  1296.                 not their password (yes,  passwords can be nothing)  then the 
  1297.                 software jumps to auto-name-detect-off name entry. 
  1298.  
  1299.                 If the user has defined a logon note, it will be shown during 
  1300.                 the login process.
  1301.  
  1302.                 The callers minutes-left-today statistics will then be shown.
  1303.                 
  1304.                 If the caller has any unread mail waiting for them, they will 
  1305.                 be given the option to read it at login.   By default,  a "do 
  1306.                 not  read now"  is executed if the user just hits  [Enter] to 
  1307.                 the  read-mail-now question--for those  with  overly  anxious 
  1308.                 fingers  (so they don't hit [Enter] accidentally just as  the 
  1309.                 message  starts  displaying--when  they  were  just  slamming 
  1310.                 [Enter] to get to the main menu quicker).  
  1311.  
  1312.                 If the caller has multiple messages waiting,  they may select 
  1313.                 to Scan the messages (hitting "s")  which gives a single line 
  1314.                 of information about each message waiting for them. 
  1315.  
  1316.                 The  login  process  can be defined as the session  from  the 
  1317.                 moment  of connect to when the primary menu is reached.    At 
  1318.                 any point during the login process, the sysop may define that 
  1319.                 one or more ANSI's be displayed.   They sysop may also add or 
  1320.                 delete  various other capabilities (such as news)   that  can 
  1321.                 appear during the login process. 
  1322.  
  1323.                 See also: MENU SYSTEM, LogN, Welc, STRT
  1324.  
  1325.  
  1326. READING         When  you  select a reading messages command from a menu  you 
  1327. MESSAGES        will  be given the range of message numbers and the number of 
  1328.                 new messages.  You will be asked to enter a message number to 
  1329.                 start at, or type "N" to start at the first new message.  The 
  1330.                 exception to this is when logging in and reading Private Mail 
  1331.                 (if you are not a message-op),   then  it  just  displays the 
  1332.                 first appropriate  message to the command (such as first new, 
  1333.                 or first to/from the sender, etc.). 
  1334.                 
  1335.                 A message is then displayed.
  1336.                 
  1337.                 After  the message is a command line where the software waits 
  1338.                 for you to type your next command.  The user may set a toggle 
  1339.                 to  decide  whether the command line should come  after  each 
  1340.                 message,   or  only messages to/from them.   By  turning  the 
  1341.                 toggle OFF,  the user is basically doing a continuous message 
  1342.                 reading. 
  1343.  
  1344.                 When reading the text body of a message,  you may type any of 
  1345.                 the   command  line  keys.    "N"   for  "next  message"   is 
  1346.                 particularly useful when doing a continuous mail read. 
  1347.                 
  1348. Header          Users  have  a toggle which they may set ON to tell them  the 
  1349.                 number of lines in that message.   If there are less than  10 
  1350.                 lines in the message, then the number will not be displayed. 
  1351.  
  1352.                 In  addition to line count,  the following are toggles that a 
  1353.                 user may turn on/off: 
  1354.                   Showing the number of replies the message has.
  1355.                   Showing the number of times the message has been read.
  1356.                   Showing the date the message was last read.
  1357.  
  1358.                 If the sender or receiver of the message is no longer a user; 
  1359.                 this fact will be displayed. 
  1360.  
  1361.                 If the message base has a NET attribute,  and the net address 
  1362.                 is  not  zero  or your's,  than the net address will  also be 
  1363.                 displayed. 
  1364.  
  1365.                 Messages have a counter that is updated each time the message 
  1366.                 has  been  read.   When the message-op of the area reads  the 
  1367.                 message, however, the counter is not increased.   This allows 
  1368.                 you to, say, review Private Mail without a user wondering why 
  1369.                 his private message says "read 2 times". 
  1370.  
  1371. Body            A  message  area  toggle  may be set to  show  "hidden"   net 
  1372.                 information  for NET messages as well.   The information then 
  1373.                 shown is: 
  1374.                   The NET attributes that are ON.
  1375.                   Hidden "Kludge" lines.  Such as PID and MSGID.
  1376.                   EchoMail/Conference Mail origin, tear, and seen-by lines.
  1377.  
  1378. Command Line    The  commands below will not be listed if the user cannot  do 
  1379.                 them. 
  1380.  
  1381.                 A number may be entered.   This is a "jump to number"  order. 
  1382.                 The   active  message  in  the  current  message  area   that 
  1383.                 corresponds  to  that number will then be displayed.   If  no 
  1384.                 message has that number, then the first message with a higher 
  1385.                 number is displayed. 
  1386.                 
  1387.                 Auto-detect  for  ZModem  and BiModem uploads is  also  done.  
  1388.                 Unlike  the entering messages command line,  the uploads  are 
  1389.                 not automatically assumed to be file attaches,  the  software 
  1390.                 will  exit  reading of messages and go to the menu,  where it 
  1391.                 will then accept your uploads into upload area 001.
  1392.  
  1393. Again           Read the same message again.
  1394.  
  1395. Continue        This command will only appear for the author of the  message, 
  1396. message         and only if they selected "Finish later" to save the message. 
  1397.  
  1398.                 This  command  will allow them to continue the message as  if 
  1399.                 they had never  stopped.   It jumps them right back  into the 
  1400.                 entering message text system. 
  1401.  
  1402.                 See also: ENTERING MESSAGES
  1403.  
  1404. Delete          Delete the current message.
  1405.  
  1406.                 Only the sender,  receiver,  or message-op may do this.   The 
  1407.                 message base must not have the DEL attribute ON. 
  1408.  
  1409.                 When you delete a message,  it is still there until you purge 
  1410.                 it--a flag is merely set in the message's header. 
  1411.                 
  1412. Edit            You  may edit/alter an already sent  message.    It is simple 
  1413.                 search and replace.  You give it a string to search for,  and 
  1414.                 a replacement string, and it does it. 
  1415.  
  1416.                 For historical accuracy,  the replaced text is never "really" 
  1417.                 replaced.    Editing  gives you an opportunity to clean up  a 
  1418.                 message.  But it also offers an opportunity to "rewrite" what 
  1419.                 you  said.   To stop any kind of abuse,  what is done is  the 
  1420.                 original text has a backspace character after each character-
  1421.                 -too   fast  to  notice  when  reading,   but  noticeable  in 
  1422.                 backscroll/capture buffers. 
  1423.  
  1424.                 Example,  I  have the message "Howdy,  thar!",  and decide to 
  1425.                 edit out "thar"  and replace it with "there".   When reading, 
  1426.                 it is seen as "Howdy,  there!",  but in the backscroll buffer 
  1427.                 you might see it as "Howdy, t▓h▓a▓r▓there!" depending on what 
  1428.                 type  of  communication  program you are  using.   Historical 
  1429.                 accuracy is maintained,   while giving the ability  to  alter 
  1430.                 already-sent messages. 
  1431.  
  1432.                 Only the sender, receiver, or message-op may edit it.
  1433.  
  1434. Forward         You  may forward the message being read  to  another  message 
  1435.                 base or another user. 
  1436.  
  1437.                 A note, "Forwarded from" is added to the top of the message.
  1438.  
  1439.                 A  sub-note may attached to the top or bottom of the message. 
  1440.                 This is useful for explaining why the message was  forwarded, 
  1441.                 or  too  add a comment before sending it onto the next person 
  1442.                 or message base. 
  1443.  
  1444.                 Only  the  sender,  receiver,  or message-op  may  forward  a 
  1445.                 message.   The  message base must not have the DEL  attribute 
  1446.                 set. 
  1447.  
  1448.                 Message base attributes,  such as ANON or ALL,  are  ignored.  
  1449.                 If the message has normal TO/FROM fields,  then if moved to a 
  1450.                 message  base  with  those special  attributes,   will  still 
  1451.                 contain the normal TO/FROM fields,  rather then be given  the 
  1452.                 "FROM:  Anonymous"  or "TO: Fellow Sentient Beings"  to which 
  1453.                 that area normally demands. 
  1454.  
  1455. Get files       This  option  appears  when  files  attaches  exist  for  the 
  1456.                 message.  It does not appear for the author of the message.
  1457.                 
  1458.                 This option is used to download those file attaches.
  1459.  
  1460.                 The  files  successfully  downloaded are subtracted from  the 
  1461.                 user's can-download bytes and daily time stats. 
  1462.  
  1463.                 If there is only one file attached, it will begin sending it.  
  1464.                 For more than one attach,  it will ask you for a file name of 
  1465.                 one to download. 
  1466.  
  1467. Give files      This  option  only  appears when "files  are  attached"   was 
  1468.                 selected when entering the message.  It also only appears for 
  1469.                 the author of the message. 
  1470.  
  1471.                 The  author  can use this command to continue or add  to  the 
  1472.                 uploads  related  to a particular message.   This command  is 
  1473.                 mainly useful for finishing <incomplete> file attaches. 
  1474.  
  1475.                 A "continue message" for file attaches.
  1476.  
  1477.                 The  files are subtracted from the user's can-download  bytes 
  1478.                 and  daily  time  stats.   This is done  for  all  the  files 
  1479.                 attached  to the message,  and regardless of whether  one  or 
  1480.                 more  of the files were successful or not.   That  may  sound 
  1481.                 strict, but it helps discourage use of the file attach system 
  1482.                 as an upload system (for interpersonal uploads). 
  1483.  
  1484. Next            Read the next message in the message base,  or move onto  the 
  1485.                 next message base if reading mail at login or using the "Read 
  1486.                 All New Mail" command. 
  1487.  
  1488. Previous        Read the previous message in the current message base.
  1489.  
  1490.                 If reading  mail at login,  or using the "Read All  New Mail" 
  1491.                 command,  and there are no previous messages,  it does not go 
  1492.                 to the previous area, but exits the reading of messages. 
  1493.  
  1494. Reply           Enter  a  message,a  reply,   to the sender  of  the  current 
  1495.                 message. 
  1496.                 
  1497. View a file     This  option  appears  when  files  attaches  exist  for  the 
  1498. attach          message. 
  1499.  
  1500.                 This command will display the file.   Nothing fancy is  done, 
  1501.                 it simply sends the contents of the file. 
  1502.                 
  1503.                 This is extremely useful sometimes.  It allows a user to post 
  1504.                 a message greater than 100 lines.  You could maintain a small 
  1505.                 library of text files in a message. 
  1506.  
  1507.                 Disadvantages  with  this are that you cannot quote from  the 
  1508.                 file, and it relies on the formatting of the file rather than 
  1509.                 then internal word wrapping/etc. formatting stuff. 
  1510.  
  1511.                 If there is only one file attached, it will begin showing it.  
  1512.                 For more than one attach,  it will ask you for a file name of 
  1513.                 one to view. 
  1514.                 
  1515. User            This brings up the user modification screen,  allowing you to 
  1516. maintenance     modify any users record.
  1517.  
  1518.                 Only the sysop may do this.
  1519.  
  1520.                 See also:  User
  1521.  
  1522. Sysop DB        This  takes  you  to the  Sysops  database.    Here  you  can 
  1523.                 add/modify/list/delete  the entries in your "who is  a sysop" 
  1524.                 database.     Convenient for when users tell you in  messages 
  1525.                 that they are sysops. 
  1526.  
  1527.                 Only the sysop may do this.
  1528.  
  1529.                 See also:  DATABASER
  1530.  
  1531. / AI's Go Fish  This sends the user a quoted reply of their message, and adds 
  1532.                 a note that they should look for the information themselves.  
  1533.                 
  1534.                 The  message is sent from the AI.   The original  message  is 
  1535.                 deleted. 
  1536.  
  1537.                 Only the sysop may do this.
  1538.  
  1539.                 The text of the reply is stored in BLOCKS.TXT block number 7.  
  1540.                 You may edit it to your liking. 
  1541.     
  1542. ? Peer Review   This command will send the message to a special message file, 
  1543.                 delete the message, and then send a prepared AI reply message 
  1544.                 to  the user.   The user "undergoing Peer Review"   attribute 
  1545.                 (bit "0") is also turned ON. 
  1546.                 
  1547.                 Only the sysop may do this command.
  1548.  
  1549.                 The  special message file is a Peer Review MESSAGE.Pxx  file, 
  1550.                 from  which users participating in Peer Review will get the 
  1551.                 information to make their voting decisions. 
  1552.  
  1553.                 If you  execute this command when the user already has a Peer 
  1554.                 Review  file,  then this message is appended to that file--to 
  1555.                 provide further information for reviewers. 
  1556.  
  1557.                 See also: SETTINGS, PEER REVIEW
  1558.  
  1559. ! Re-Locate     This  command "moves"  a  message to  another  message  base. 
  1560.                 Essentially  it  is forwarding but  without  the  "forwarding 
  1561.                 note" etc.
  1562.                 
  1563.                 It is only for the sysop. 
  1564.  
  1565.                 The message will be given the next message number appropriate 
  1566.                 to that area. 
  1567.                 
  1568. @ Header Edit   This command will allow editing of the header information for 
  1569.                 the message. 
  1570.  
  1571.                 Header  information  includes things  like:   to/from/subject 
  1572.                 fields, attributes, net addresses, and statistical counters. 
  1573.  
  1574.                 Only the sysop may do this.
  1575.  
  1576. ^ Re-Inform     This command is available only to the sysop.   It is also not 
  1577.                 shown on the reading mail command line. 
  1578.  
  1579.                 This command will "re-flag" the user of the TO: field telling 
  1580.                 them they have  a message.   This command is useful after you 
  1581.                 have   accidentally   deleted   your   USERMSGS   file--since 
  1582.                 rebuilding it sets all pointers/etc.  to zero--this should be 
  1583.                 used on all "(Rcvd: -NO-)" messages. 
  1584.  
  1585.                 It  is mainly only used for when something goes wrong.    But 
  1586.                 you can pester the user by re-sending a message they may have 
  1587.                 ignored also. 
  1588.  
  1589. Misc.           If the sender of the message had included file attaches,  and 
  1590.                 you respond with "Peer Review"  or "AI's Go Fish", than these 
  1591.                 file attaches are deleted as  the original message is deleted 
  1592.                 automatically. 
  1593.  
  1594.                 Header Edit,  Continue Message, Edit, Forward,  and Re-Locate 
  1595.                 all  will correctly move the original message's file attaches 
  1596.                 when the new message is created. 
  1597.                 
  1598.                 When displaying the body of a message,  [Tab] can be used  to 
  1599.                 pause  the message.   When at the command line,  [Tab]  works 
  1600.                 like the [N]ext command. 
  1601.  
  1602.  
  1603. ENTERING        Leaving messages is a two step process.   The first step asks 
  1604. MESSAGES        you about the message attributes:  subject,  etc.  The second 
  1605.                 step  handles  the  entering of the message  text,   and  the 
  1606.                 various entering messages commands, most notably: saving. 
  1607.  
  1608.                 During this first step,  entering of information,  you select 
  1609.                 the  first  letter of what you want to do/change,   and  then 
  1610.                 [Enter] alone to move on to entering the message's text body. 
  1611.  
  1612.                 Allowable commands are:  In, To, At,  Subject,  Line numbers, 
  1613.                 Quote  original,  Carbon Copies,  File Attaches,  and  Upload 
  1614.                 message  (you  type only the first letter).   Some  of  these 
  1615.                 options may not work--either because of  the type of message, 
  1616.                 type  of message area,  or with each other--then the key will 
  1617.                 not  be allowed,  and possibly an informational note will  be 
  1618.                 displayed when they try that key. 
  1619.  
  1620. Heading Line    The  first  thing  displayed is a heading line.    This  line 
  1621.                 contains  information  about  the type of mail  to  be  sent: 
  1622.                 Public, Private, Anonymous, and Net. 
  1623.  
  1624.                 Because there are only two types of "From:", the posters name 
  1625.                 or Anonymous, there is no "From:" field shown. 
  1626.  
  1627. In              This is  the name of the message area to which the message is 
  1628.                 being posted. 
  1629.                 
  1630.                 This command option can be used to re-locate the message to a 
  1631.                 different  message area.   Only those message areas which the 
  1632.                 user both has toggled ON, and access to, are offered. 
  1633.  
  1634. To              To  whom you wish the message to go.   For replies,  this  is 
  1635.                 given the name of the poster of the original message. 
  1636.  
  1637.                 If the message area allows it, "All" can be used.
  1638.  
  1639.                 If the message area is an EchoMail or NetMail area,  then any 
  1640.                 name  be entered,  otherwise the name entered must be that of 
  1641.                 an active user. 
  1642.  
  1643.                 Entering  "Sysop"  will expand out to the message-op of  that 
  1644.                 area.    Entering "Fellow"  will change to "All",  which then 
  1645.                 changes to "Fellow Sentient Beings". 
  1646.                 
  1647.                 Note:  If you  do not want "ALL"'s to become "FELLOW SENTIENT 
  1648.                 BEINGS",   then  just  replace  all  occurrences  of  "FELLOW 
  1649.                 SENTIENT BEINGS"  in LINES.TXT and SHORT.TXT with "ALL".   Be 
  1650.                 sure to notice, and keep, proper case (eg.  "All" vs. "ALL").  
  1651.                 Similarly  if you want something other than "Fellow  Sentient 
  1652.                 Beings" (like "Friendly Computer Users"). 
  1653.  
  1654.                 You  may use "*"  or "?".   This will bring up a list of  the 
  1655.                 first  18  names matching the characters you have entered  so 
  1656.                 far. 
  1657.  
  1658. Subject         The subject of the message.   For replies,  this is forced to 
  1659.                 be the same as that of the original message. 
  1660.  
  1661.                 The  subject  field of a  message  is  a  variable  thing--it 
  1662.                 depends  on the type of text you type.   This is because  the 
  1663.                 message subject's text is compressed. 
  1664.  
  1665.                 If  you  type  a  long subject,   and  the  system  "deletes" 
  1666.                 characters at the end of it after you hit [Enter],  then  you 
  1667.                 know  some of subject has just been deleted because it turned 
  1668.                 out to be too long. 
  1669.  
  1670.                 All  subjects  have any leading spaces trimmed off.
  1671.  
  1672. At              This  is the NetMail address to send the message to  (if  the 
  1673.                 area is a NetMail area). 
  1674.  
  1675.                 Hit a "?" to get some help on what to enter.
  1676.  
  1677.                 Merely hitting return will set it to zero--making it a local-
  1678.                 only message. 
  1679.  
  1680.                 The  net address format is xxxxx:yyyyy/zzzzz.   Where "xxxxx" 
  1681.                 is the zone number, "yyyyy" is the net number, and "zzzzz" is 
  1682.                 the node number.  But you can type "x.y.z" or "x y z" or most 
  1683.                 anything and it will work.
  1684.  
  1685.                 The  software  uses your net address to fill in  any  missing 
  1686.                 information.   That is, if your address is "a:bbb/cccc", then 
  1687.                 entering  only  "##"  will be converted to  "a:bbb/##",   and 
  1688.                 entering "##/##" will be converted to "a:##/##". 
  1689.  
  1690.                 A private message without a net address in a Private  NetMail 
  1691.                 area will be,  instead,  correctly put into Private Mail area 
  1692.                 (001) instead. 
  1693.                 
  1694. Line numbers    This  toggles ON/OFF whether you wish to see line numbers  at 
  1695.                 the start of each line when entering the message text. 
  1696.  
  1697.                 It  is  very tricky to edit a message without  line  numbers.  
  1698.                 But turning line numbers OFF allows one to put more text into 
  1699.                 a message,  and makes ASCII sends (from caller)  of text more 
  1700.                 reliable. 
  1701.  
  1702. Quote original  This  will  quote  the entire  original  message  when  doing 
  1703.                 replies. 
  1704.  
  1705.                 When  entering  the body of the message,  you  may  then  use 
  1706.                 Delete to remove any quote lines you do not want,  and Insert 
  1707.                 to insert between quote lines if you want. 
  1708.  
  1709.                 You  cannot upload a prepared message and quote the  original 
  1710.                 at the same time. 
  1711.  
  1712. Carbon Copies   You may send multiple copies  of  private  messages  to  many 
  1713.                 users.  These are known as CC's. 
  1714.  
  1715.                 When you save the message,  the software will ask you whether 
  1716.                 you  wish  to  include all these names at  the  top  of  each 
  1717.                 message, or not. 
  1718.  
  1719.                 You are not able to send CC's in NetMail,  EchoMail,  or with 
  1720.                 File Attaches. 
  1721.  
  1722. Upload message  Upload a prepared message. 
  1723.                 
  1724.                 You  will not be allowed to select this option if you already 
  1725.                 have selected to quote the original message. 
  1726.  
  1727.                 The  uploaded  file  should be  a standard text  file.    Not 
  1728.                 compressed, nor any other weird characters (those below ASCII 
  1729.                 32).  ANSI codes and graphics characters are allowed. 
  1730.                 
  1731.                 When  this  feature  is used from the console,   it is called 
  1732.                 importing.   You will then be asked for a pathname to load in 
  1733.                 as the message. 
  1734.  
  1735.                 In any case, the file containing the message is deleted after 
  1736.                 it is processed into an actual message. 
  1737.                 
  1738.                 Processing  includes truncating any additional  lines  beyond 
  1739.                 your  set  maximum  number  of  lines  allowed  in  messages.  
  1740.                 Normally that is 98 lines. 
  1741.                 
  1742.                 When used at the console, if [Enter] alone is used,  then the 
  1743.                 software looks for,  and imports,  all .PKT and .REP files in 
  1744.                 the d:\BBS\NODE.???\TEMPAREA directory. 
  1745.                 
  1746.                 This  is  useful  if  you downloaded .PKT's  or  .REP's  from 
  1747.                 someplace else,  or the system was not able to unpack  a .PKT 
  1748.                 at  the time of its arrival due to lack of drive  space.   To 
  1749.                 minimize risk of deletion,  you should shell to DOS and  copy 
  1750.                 the files into the directory just before selecting to enter a 
  1751.                 message at a menu. 
  1752.  
  1753.                 Also,   at the console,  you may specify a specific  .PKT  to 
  1754.                 import.  Of course, you can also specify a specific text file 
  1755.                 to simply import as message text. 
  1756.                  
  1757.                 See also: SETTINGS
  1758.                 
  1759. File Attaches   Select this if you wish to attach files to the message.
  1760.  
  1761.                 When  the message is saved,  the software will ask  that  the 
  1762.                 author  upload  the files to be attached.   Or,   if  at  the 
  1763.                 console,   the pathnames you wish to duplicate and attach  to 
  1764.                 the message. 
  1765.  
  1766.                 The  files are subtracted from the user's can-download  bytes 
  1767.                 and  daily  time  stats.   This is done  for  all  the  files 
  1768.                 attached  to the message,  and regardless of whether  one  or 
  1769.                 more  of the files were successful or not.   That  may  sound 
  1770.                 strict, but it helps discourage use of the file attach system 
  1771.                 as an upload system (for interpersonal uploads). 
  1772.  
  1773.                 Files  attaches are stored in the MSGSTUFF directory.    Each 
  1774.                 message with files attached will have its own directory under 
  1775.                 the format:  MessageNumber.Area  Example:  Private Mail (area 
  1776.                 001) message number 5000 would be stored in \MSGSTUFF\5000.1.  
  1777.                 You,  the sysop,  may add or delete the files,  or directory, 
  1778.                 without concern--there is no  internal tracking done for  the 
  1779.                 file  attaches  (the directory is  either there and  contains 
  1780.                 files, or it is not). 
  1781.  
  1782.                 This  is useful for the future especially.   Since users  can 
  1783.                 upload voice mail (.MOD/.VOC/etc. files) as the message.   If 
  1784.                 one  of you out there can figure out how to turn  on/off  the 
  1785.                 modem carriers,  then a command to record voice mail could be 
  1786.                 added  (a  similar  command  would be  needed  in  the  users 
  1787.                 communication  program).   Otherwise we will have to wait for 
  1788.                 video phones to hook up to computers. 
  1789.  
  1790.                 If  you forget to select File Attaches,  or just want  to  be 
  1791.                 lazy,  then you  can "just upload them"  at the command line.  
  1792.                 This will cause the message to  be saved, and for it to begin 
  1793.                 receiving the  transferred  files  and  attach  them  to  the 
  1794.                 message. 
  1795.  
  1796.                 If the upload is aborted,  or you want to add more later, you 
  1797.                 can do so from the reading messages command line. 
  1798.  
  1799.                 You cannot do File Attaches with Carbon Copies.
  1800.                 
  1801.                 
  1802. Body            Entering of text is straight forward.
  1803.                 
  1804.                 Quoted text shows up bracketed. 
  1805.                 
  1806.                 Hitting backspace can go to the previous line. 
  1807.  
  1808.                 Cursor movement keys (up, down, left, right) are converted to 
  1809.                 backspaces (up,  left)  or spaces (right, down).  There is no 
  1810.                 moving about the message with the cursor keys. 
  1811.                 
  1812.                 With the exception  of the cursor movement codes,  ANSI codes 
  1813.                 are allowed in messages. 
  1814.                 
  1815.                 Technical note:   These cursor movement keys  are "[A", "[B", 
  1816.                 "[C",  and "[D".  Now,  these codes are a subset of the  full 
  1817.                 ANSI  set--so  if a user wanted to  upload  a  complex  ANSI, 
  1818.                 theses  codes might be part of it and screw it up.   But  the 
  1819.                 vast  majority of times these keys get  encountered  are when 
  1820.                 the  user tries to move around the screen to do editing.   To 
  1821.                 use the same  codes in an ANSI image  as part of the message, 
  1822.                 one should use: "[1A", "[1B", "[1C", and "[1D". 
  1823.                 
  1824.                 There  is trouble,  however,  with ANSI lines that exceed  70 
  1825.                 characters.   So,  while ANSI's are best in single-line  form 
  1826.                 for menus,  for messages they need to be in multi-line  form.  
  1827.                 The  Draw  can  handle both forms.   To put ANSI  codes  into 
  1828.                 messages remotely,   you must either do an ASCII file send of 
  1829.                 an ANSI file, or upload that part of the message as a message 
  1830.                 upload  (then  the cursor movement keys are  allowed  in  the 
  1831.                 ANSI). 
  1832.  
  1833.                 ANSI's jumping all over the screen using either positional or 
  1834.                 cursor  movements keys is simply not the way to do in-message 
  1835.                 ANSI's.    The proper way is to design your ANSI to display a 
  1836.                 line of ANSI text/drawing, do a CR/LF,  then display the next 
  1837.                 line of ANSI text/drawing,  etc.  until done.   Like  sending 
  1838.                 ASCII text, but with hidden ANSI codes. 
  1839.  
  1840.                 Quoting  of  text with ANSI characters can mess up the  quote 
  1841.                 brackets'   appearance--unless  one  follows  the  guidelines 
  1842.                 above. 
  1843.  
  1844.                 ANSI   codes   can   be   entered  at   the   console   using 
  1845.                 <Control><Left> to generate the ASCII 27,  then type the rest 
  1846.                 of the ANSI string you want. 
  1847.  
  1848.                 Graphics characters (ASCII codes above 127)  are also allowed 
  1849.                 in  messages.   This requires that the  users  communications 
  1850.                 program be able to send them.   There is no way for a  person 
  1851.                 at the console to generate these characters as yet. 
  1852.  
  1853.                 Exit to the command line by hitting enter twice.
  1854.  
  1855.                 One may also type: /s, /es, /post, or /exit at the start of a 
  1856.                 line  to  immediately  save and  exit  the  entering  message 
  1857.                 process.  All the commands work alike. 
  1858.  
  1859.                 Hanging  up saves the message (as "finish later"),  but loses 
  1860.                 the line being worked on. 
  1861.  
  1862.                 If  a user has toggled active grammar checking to  ON,   then 
  1863.                 each word is checked as they enter it,  and a beep is sounded 
  1864.                 when  that  word is not found.   User's should not  have this 
  1865.                 option ON when doing an ASCII send of message text from their 
  1866.                 communication  program's buffer or from a file at their  end.   
  1867.                 This  is  because  the beeping might  screw  everything  up--
  1868.                 although  I  suspect  it may be OK if both of you  are  using 
  1869.                 modems with MNP 4 or better. 
  1870.  
  1871.                 A //G may  be typed at the start of any line to toggle active 
  1872.                 grammar  checking from ON to OFF,  and vice-versa.   The  "G" 
  1873.                 must be in upper case. 
  1874.  
  1875.                 See also:  Colorizing
  1876.  
  1877. Command Line    Besides  the  commands below,   auto-detect  for  ZModem  and 
  1878.                 BiModem uploads is also done.   Doing an upload in the middle 
  1879.                 of  a  message will not destroy the message,  and it will  be 
  1880.                 saved before starting the transfer. 
  1881.  
  1882.                 Users  may  set toggles to determine if the total  number  of 
  1883.                 words, lines, and/or characters should be shown. 
  1884.  
  1885.                 Editing  by line number is much more difficult when the  user 
  1886.                 has "no-numbers message entry" toggled to ON. 
  1887.  
  1888. %               Save the message to a message file.
  1889.  
  1890.                 Only the sysop may do this.
  1891.  
  1892.                 The message body is then stored in a MESSAGE.xxx file.  Which 
  1893.                 then  can  become  part  of other  messages  via  the  %%%xxx 
  1894.                 command. 
  1895.  
  1896. Abort           Aborts the current message.  No message is sent.
  1897.  
  1898. Continue        This lets you continue your message from the point where  you 
  1899. entering        left off. 
  1900.  
  1901. Delete lines    Use  this to delete a line or a  block  of  lines  from  your 
  1902.                 message. 
  1903.                 
  1904. Edit            This option will search for an exactly matching string in the 
  1905.                 message, and replace it with another string you supply. 
  1906.                 
  1907.                 This  is  the  command  to use for fixing  up  typos  in  the 
  1908.                 message. 
  1909.  
  1910. Finish later    This  will save the message as a special "I want to finish it 
  1911.                 later" message. 
  1912.  
  1913.                 What this means is that when you (the author)  again read the 
  1914.                 message,   you will  have  an  option:   "Continue  message".  
  1915.                 Selecting this option will let you continue the message, edit 
  1916.                 it, etc. just as if you had never stopped. 
  1917.  
  1918.                 After saving,  the author can still (or not)  upload any file 
  1919.                 attaches if they wish. 
  1920.  
  1921.                 The  message  is saved--and actually sent.   If the  receiver 
  1922.                 logs  on  before you have finished (at a later time or  date) 
  1923.                 then they will see it as a completed message.
  1924.  
  1925.                 In theory, anyone could just use this instead of Save to save 
  1926.                 all  their  mail.   Then later modify what they said  in  the 
  1927.                 message, and proclaim "that is what I said originally".   The 
  1928.                 only  defense for this is that the  message numbers  will  be 
  1929.                 different,   and  the  sysop  could  undelete  the   original 
  1930.                 (unfinished) message if he had to. 
  1931.  
  1932.                 This command is not available if the message has CC's.
  1933.  
  1934. Grammar check   This does a spell check on your message,  and offers you  the 
  1935.                 opportunity to correct the misspelled words. 
  1936.  
  1937.                 When  a  word is not found,  and the user hits  [Enter]  when 
  1938.                 asked for the corrected spelling,  that word is put into your 
  1939.                 WORDS.NEW  file.    This file will be utilized in the  future 
  1940.                 when I add the ability to update the WORDSx.DAT files. 
  1941.  
  1942.                 While  it is  checking,  hitting [Enter] or any of  the valid 
  1943.                 entering  messages  command keys will bring you back  to  the 
  1944.                 command line. 
  1945.  
  1946. Insert lines    Use this to insert text into your message.
  1947.  
  1948.                 You will be asked which line number to insert before, then it 
  1949.                 will  allow  you  continue  using the  normal  message  entry 
  1950.                 system. 
  1951.  
  1952. List            This lists your message, including line numbers.  
  1953.                 
  1954.                 Colorization codes are not acted upon, but simply displayed. 
  1955.                 
  1956.                 While  it is  listing,   hitting [Enter] or any of  the valid 
  1957.                 entering  messages  command keys will bring you back  to  the 
  1958.                 command line. 
  1959.  
  1960. Preview         This  displays your message exactly as it  will  be  seen  by 
  1961.                 others when reading it. 
  1962.                 
  1963.                 Colorization codes are acted upon.
  1964.  
  1965.                 While  it is displaying,  hitting [Enter] or any of the valid 
  1966.                 entering  messages  command keys will bring you back  to  the 
  1967.                 command line. 
  1968.  
  1969. Save            This compresses and saves the message.
  1970.                 
  1971.  
  1972. MESSAGE FILES   Using an editor (or the "%"  command)  you,  the  sysop,   or 
  1973.                 whoever  you  designate as the message-op (for an area)   can 
  1974.                 send  messages  that include a special  "load  message  file" 
  1975.                 command.  This command, "%%%" when embedded within a message, 
  1976.                 will cause the software to search out a file and load it into 
  1977.                 the message when reading. 
  1978.  
  1979.                 Message files start with the name "MESSAGE."  and contain a 3 
  1980.                 letter extension ("xxx",  so "MESSAGE.xxx").   It provides  a 
  1981.                 method  of  sending lots of identical letters while  using  a 
  1982.                 minimum amount of drive space. 
  1983.  
  1984.                 Basically all these message files contain is text.   You  may 
  1985.                 create, or alter, these files with any standard text editor. 
  1986.  
  1987.                 Usually, though, you will just create the message and use the 
  1988.                 "%"   command to save it to a file.   With this method,   the 
  1989.                 computer increments file extensions ("xxx")  from the highest 
  1990.                 found  (example:  if you have MESSAGE.009   then  MESSAGE.010 
  1991.                 would be created).  However, you may re-name these extensions 
  1992.                 to any three characters you like. 
  1993.  
  1994.                 Message files should not exceed 8,192  bytes in  size.  To do 
  1995.                 so is risky since it relies on string space. 
  1996.                 
  1997.                 Inserting  a  message  file into  a  message  is  simplicity: 
  1998.                 "%%%xxx"  anywhere inserts the message ("xxx").   They do not 
  1999.                 need their own line.   They can be in the middle of a "word": 
  2000.                 "You  should%%%xxx.".    They  can  be  recursive--the   file 
  2001.                 messages  may contain "%%%"  codes themselves--warning,   the 
  2002.                 system  does not protect you from looping,  which will  crash 
  2003.                 the  system (looping:  xxx contains reference to xxx,  or xxx 
  2004.                 contains reference to yyy and yyy contains reference to  xxx, 
  2005.                 etc.) 
  2006.  
  2007.                 The system only expands the "%%%"  codes into messages if the 
  2008.                 message was sent by: the AI, the sysop, or the message-op for 
  2009.                 the  area.    Any  other  authors  and the  reader  will  see 
  2010.                 "%%%xxx".   Similarly for message  files that are not  found, 
  2011.                 "%%%xxx" gets displayed. This allows you to use "%%%%%%%%%%%" 
  2012.                 without worrying, and users cannot find out your message file 
  2013.                 contents, nor use them in their own messages. 
  2014.  
  2015.                 Mass  Mail  uses these to send letters to users of a  defined 
  2016.                 security  level value.   You also need to configure a message 
  2017.                 to  be sent to new users (to introduce them to you,  the BBS, 
  2018.                 and the interface). 
  2019.                 
  2020.                 There is nothing stopping you  from creating the messages on-
  2021.                 the-fly and just using  the  "%%%" codes instead of re-typing 
  2022.                 large blocks of text. 
  2023.  
  2024.                 The  "%"  command lets you use the message entry system as  a 
  2025.                 text editor.   However, remember that messages are divided up 
  2026.                 by "paragraphs"--a paragraph is text followed by a CR/LF  (an 
  2027.                 [Enter]).   Remember,  text is word wrapped.   So if you edit 
  2028.                 the  file,   you will probably see lots of lines that  extend 
  2029.                 past   column  80.    If  you  do  choose  to  edit  messages 
  2030.                 externally,  I  recommend only using CR/LF's where necessary, 
  2031.                 let the software do  the word wrap (really,  you just need to 
  2032.                 follow the same advice as Uploading/Importing message uses). 
  2033.  
  2034.                 You  can  use  a standard text editor to edit or  create  the 
  2035.                 messages.    I  recommend you hit [Enter] only at the end  of 
  2036.                 paragraphs (have long lines).  This allows the software to do 
  2037.                 the  word wrapping.   Whereas having a CR/LF after each  line 
  2038.                 will look weird if the message is quoted. 
  2039.  
  2040.                 Normally only the sysop and the AI may send messages with "%" 
  2041.                 codes.    However,  you may change a toggle to also allow all 
  2042.                 message-op's  to  also send messages with "%"   message  file 
  2043.                 codes. 
  2044.  
  2045.                 Message files are not limited by maximum number of lines.  So 
  2046.                 you   could  use  these  to  create  really  long   messages.  
  2047.                 Although,  if  a user quotes the message,  they will  need to 
  2048.                 delete a lot of lines. 
  2049.  
  2050.                 %%%LOK is a special order.  It will set the user's locked-out 
  2051.                 attribute, so that when they are done reading messages,  they 
  2052.                 will  be  hung  up on and locked out  of  the  system.    The 
  2053.                 "%%%LOK"  command is ignored until the name logged in matches 
  2054.                 the  TO:  field of the message.   This allows you,  or anyone 
  2055.                 besides  the  person the message is to,  to safely  read  the 
  2056.                 message. 
  2057.  
  2058.                 With any "%%%xxx"  command,  three stages are done:  first we 
  2059.                 see  if there is a MESSAGE.xxx file to display,  if there is, 
  2060.                 then we show it.   Second, if no MESSAGE.xxx file exists,  we 
  2061.                 see if it is a special command,  if it is,  we do the command 
  2062.                 if possible.  Lastly,  we simply display the "%%%xxx" because 
  2063.                 we cannot do anything with it. 
  2064.  
  2065.                 A  serious draw back with this:  one can never remember which 
  2066.                 MESSAGE.xxx  contains  what.   In a future version,  I   will 
  2067.                 change this to a "%%%pathname%%%" command. 
  2068.                  
  2069.                 See also: SETTINGS, TOGGLES
  2070.  
  2071.  
  2072. RAMBLINGS       Ramblings  are  both message files  and  text  files.    They 
  2073.                 contain messages stored in text file format. 
  2074.  
  2075.                 Users append messages to the end of these files.
  2076.  
  2077.                 Unlike regular message bases, however, these utilize the same 
  2078.                 HiFilePtr system as files do.  After each logon, all formerly 
  2079.                 new  ramble entries become old.   Normal messages only become 
  2080.                 old when they, or a newer message in the same area, is read. 
  2081.  
  2082.                 Anyone can add to a ramble.
  2083.  
  2084.                 Anyone  above a defined SL may create a ramble.   The creator 
  2085.                 may  even restrict access  to the ramble by a SL (SL's higher 
  2086.                 than the sysop's are not accepted). 
  2087.  
  2088.                 Only  the creator of the ramble,  or the sysop,  can delete a 
  2089.                 ramble. 
  2090.  
  2091.                 Any ramble files containing new entries are highlighted.
  2092.  
  2093.                 Ramble file information is stored in RAMBLING.DAT, and ramble 
  2094.                 message text is stored in RAMBLE.xxx (001 to 996).  More than 
  2095.                 996 will merely overwrite 001. 
  2096.  
  2097.                 While a user cannot upload a message in file form (like  they 
  2098.                 can  with the message system)  they can do an ASCII send from 
  2099.                 their  end (which they can also do with normal messages)   to 
  2100.                 send up a prepared message. 
  2101.  
  2102.                 The ramblings menu has a statistics/title toggle option.  The 
  2103.                 statistics  are useful for finding new messages if  you  have 
  2104.                 not checked in on the rambles after a few calls. 
  2105.  
  2106.                 See also: SETTINGS
  2107.  
  2108.  
  2109. FILE AREA       You may list the contents of a file area using three formats: 
  2110. CONTENTS        Standard,  Point & Shoot,  and paged.  As you will see,  each 
  2111. LISTING         method has unique qualities. 
  2112.                 
  2113.                 With  the menu commands,  you can have the software list  all 
  2114.                 areas at once, provide a menu of all the areas,  use your own 
  2115.                 menu of all or some areas, provide a menu of some areas.  You 
  2116.                 may  put  some  or  all your file areas into  a  single  file 
  2117.                 system,   or bust them all up so they are grouped together or 
  2118.                 individually  (known  as  topical menus:  putting  a  related 
  2119.                 message area(s) and related file area(s) into the same menu). 
  2120.  
  2121.                 When  showing description lines  the software also does  some 
  2122.                 checking  to make sure things are OK.   Checks include:  file 
  2123.                 has  an entry,  file entry has the right file area,  and  the 
  2124.                 file  entry's file size is the same as the file on the  disk.  
  2125.                 The correction will be done automatically. 
  2126.  
  2127.                 The  software  maintains a global download batch.    The  P&S 
  2128.                 system  interfaces  this  directly.   The  Paged  method  has 
  2129.                 commands to use it.  There are also menu commands to use with 
  2130.                 it. 
  2131.                 
  2132.                 See also:  MENU SYSTEM
  2133.                 
  2134. Standard        This method is invoked with "LstF" commands.
  2135.                 
  2136.                 When listing,  [Enter], [Space], [Tab], "-", ".", and "!" are 
  2137.                 the valid keys. 
  2138.  
  2139.                 [Enter] stops the listing, [Space] or [Tab] will pause it.
  2140.  
  2141.                 Hitting  "-"   will  restart the listing,   in  the  opposite 
  2142.                 alphabetical  order  (A-Z or Z-A,  depending on what  it  was 
  2143.                 doing.)  Or if you are listing the area by date uploaded, the 
  2144.                 reverse (oldest to newest or newest to oldest) will be done.
  2145.  
  2146.                 Hitting  "."   will  send you into the Point and  Shoot  File 
  2147.                 Selection and Information System. 
  2148.  
  2149.                 Hitting  "!"  will show who uploaded the various files.   You 
  2150.                 can  toggle  this off for all but the file-op  of  the  area.  
  2151.                 Also  shown:   date  it  was  uploaded,   date  it  was  last 
  2152.                 downloaded, and number of times it has been downloaded. 
  2153.  
  2154.                 Files which are new to the user are highlighted white.
  2155.  
  2156.                 After the date,  or the size if date is excluded,  there  are 
  2157.                 five letters that may appear: f, g, i, p, and r. 
  2158.  
  2159.                 f appears if the file is free.
  2160.  
  2161.                 g appears if the file is a group-specific-only file.
  2162.  
  2163.                 i  appears  if the file is invisible.   Only the  file-op  or 
  2164.                 sysop will see the file entry. 
  2165.  
  2166.                 p appears if the file requires a password to download.
  2167.  
  2168.                 r appears if there is a review for the file.
  2169.  
  2170.                 When  a user tries to access a file area that his SL  is  too 
  2171.                 low for,  the message "security level too low"  will be shown 
  2172.                 instead  of the contents of the area.   This can  be  useful.  
  2173.                 Paged  file system does not do this,  and so the  user  never 
  2174.                 knows the file areas even exist.  This allows you to show the 
  2175.                 user that file areas which he does not yet have access to  do 
  2176.                 exist. 
  2177.                 
  2178. Point & Shoot   Unlike the Standard or Paged methods, the P&S method does not 
  2179. File Selection  do  any  "correcting"  of errors it finds.   It does not list 
  2180. and             files  that  are <incomplete>  or invisible.    It  does  not 
  2181. Information     highlight new files.   It does not display reviews.   It does 
  2182. System          not  do  automatic  helpful  exchanges for minute-credits  or 
  2183.                 megabytes when the user tries to exceed one of the limits. 
  2184.  
  2185.                 It  does,  however,  do things the other methods cannot.   By 
  2186.                 providing an "interface screen"  to the file area.  From this 
  2187.                 method,  a user may work on an archive,  download files,  and 
  2188.                 upload files.   Auto-detect of Zmodem and BiModem uploads are 
  2189.                 checked.
  2190.                 
  2191.                 Because  the screen size is limited,  you will need  to  make 
  2192.                 sure no file area contains more than 96 file names. 
  2193.  
  2194.                 Movement  is simple enough:  either the arrow keys or  number 
  2195.                 keys (keypad with "Num Lock" on). 
  2196.  
  2197.                 To move between file areas use "+"  to move to the next  file 
  2198.                 area, and "-" to move to the previous file area. 
  2199.                 
  2200.                 Areas which have a Scan SL greater than the users, or have a 
  2201.                 PR restriction and the user has not passed PR, will not be 
  2202.                 shown to the user.
  2203.  
  2204.                 To download files,  you must first "tag" them.   This is done 
  2205.                 by hitting the [Space],  [Enter], or "5" keys.   Tagged files 
  2206.                 can  be untagged similarly.   As you tag files,  you will  be 
  2207.                 given  a  summary  of  how much and how  long  your  download 
  2208.                 session will be.
  2209.  
  2210.                 Hit "/" to turn on the description line.   This will give you 
  2211.                 the  descriptions  for  each file as you move over  the  file 
  2212.                 names.  Hit "/" again when you want to turn it off.
  2213.  
  2214.                 Hit "?" to just give the description for a single file.  This 
  2215.                 is  much faster than "/".   If "/"  is active and you hit "?" 
  2216.                 than "/" will be turned off also. 
  2217.  
  2218.                 Hitting  "."   will switch you back to the standard  type  of 
  2219.                 contents listing. 
  2220.  
  2221.                 Use "d"   to download the files you have tagged.   Unlike the 
  2222.                 normal download menu option,  this one will not  do automatic 
  2223.                 exchanges  to help you out,  nor does it offer the option  of 
  2224.                 auto-logoff. 
  2225.  
  2226.                 Use "u" to upload.  Auto-detect of Zmodem and BiModem is also 
  2227.                 done.  Unless you do not have access,  or the current area is 
  2228.                 not  set  up as an upload area,  all uploads will go  to  the 
  2229.                 current area.   Otherwise an attempt will be made to put them 
  2230.                 in  file  area  001--if still no access,  then  you  will  be 
  2231.                 rebuffed. 
  2232.  
  2233.                 "v" will allow you View/Test/Extract from that archive.
  2234.  
  2235.                 "q" will quit you out of the P&S system.
  2236.                 
  2237.                 See  Standard  above for some information on the  description 
  2238.                 line.
  2239.                 
  2240. Paged File      This  method combines something from each of the above.    It 
  2241. System          lists  the  contents of a file area in 18  line  pages,   and 
  2242.                 allows an interface to many commands. 
  2243.  
  2244.                 There are many commands which use this method,  but "PagF" is 
  2245.                 what they are all derived from. 
  2246.  
  2247.                 File  areas  to which the user does not have access  are  not 
  2248.                 shown.    The area numbers (1..n)  that the user will see  is 
  2249.                 adjusted  properly  (if you have 4 areas and area 2 the  user 
  2250.                 has to-low a security level value for,  they still see 1,  2, 
  2251.                 3, not 1, 3, 4). 
  2252.  
  2253.                 For each file area, a title line containing the area name and 
  2254.                 number is drawn,  then 18 file descriptions.   Then a command 
  2255.                 line. 
  2256.  
  2257.                 See  Standard  above for some information on the  description 
  2258.                 line.
  2259.                 
  2260.                 The command line is like a file menu.   The following are the 
  2261.                 command options:  [Enter], ?, Quit,  area number,  Next area, 
  2262.                 Previous area,  Upload, Add to DL batch, Batch contents, Show 
  2263.                 reviews,   Download,  Extended file info,  Work  on  archive, 
  2264.                 Redraw, and Continuous. 
  2265.                 
  2266.                 With the exception of "?"  and "E",  the rest of the commands 
  2267.                 work also while descriptions are being displayed. 
  2268.  
  2269.                 If you used a "PagF"  call,  and none of the others (such  as 
  2270.                 "PagA"), then you can also type "." to go to the P&S system. 
  2271.  
  2272.                 This   does  not  have  "-"   to  reverse  order  while   the 
  2273.                 descriptions are displaying like the Standard method does. 
  2274.  
  2275.                 [Enter]  moves onto the next page if more files exist in  the 
  2276.                 area, or moves onto the next area. 
  2277.  
  2278.                 "?" brings up a listing of the valid commands.
  2279.  
  2280.                 You may just enter a file area number to jump to that area.
  2281.  
  2282.                 Upload will let you upload to the current area.   If the area 
  2283.                 does  not allow uploading,  it will try to let you upload  to 
  2284.                 area 001 instead. 
  2285.  
  2286.                 Add to DL batch is used to add files you wish to download  as 
  2287.                 the pages are displayed.   Up to 100 entries may be stored in 
  2288.                 the  batch.    The  software tallies up how  many  bytes  the 
  2289.                 downloads would use,  and will not let you add more files  to 
  2290.                 the batch that exceed your daily limit. 
  2291.  
  2292.                 Batch  contents shows you what is currently in the  DL batch.  
  2293.                 It  also offers you the opportunity to delete one or more  of 
  2294.                 the entries. 
  2295.  
  2296.                 Show  reviews  will list the reviews (if any)  for that  file 
  2297.                 area.    Only  [Enter] and [Space] area  allowed  during  the 
  2298.                 display of the reviews. 
  2299.  
  2300.                 Download allows you to download a file or the batch.   If the 
  2301.                 batch is not empty,  it will ask if you wish to download  it.  
  2302.                 You  can answer yes or no.   If yes,  it will send the  batch 
  2303.                 (and  then clear it--whether the download was aborted  midway 
  2304.                 or not).   If no, or the batch is empty, then it will ask you 
  2305.                 for a file name, and immediately start downloading that file. 
  2306.  
  2307.                 Extended file info toggles the showing of such things as  who 
  2308.                 uploaded the file, when it was uploaded, the last time it was 
  2309.                 downloaded,  and the number of times it was downloaded.    It 
  2310.                 adds two extra lines to each description line,  reducing  the 
  2311.                 number of descriptions displayed to 6 per page. 
  2312.  
  2313.                 Work   on   archive  will  ask  you  for  a  file   name   to 
  2314.                 view/extract/test. 
  2315.  
  2316.                 Redraw redraws the last screen of descriptions.
  2317.  
  2318.                 Continuous  toggles  ON/OFF  the stopping after  each  screen 
  2319.                 full.   If continuous is OFF,  then it will still stop at the 
  2320.                 end of each file area. 
  2321.                 
  2322.                 Auto-detect  of  Zmodem  and  BiModem  uploads  are  checked.  
  2323.                 Support for the "post-listing  requests  display"  toggle  is 
  2324.                 done. 
  2325.                 
  2326.                 It does not do automatic helpful exchanges for minute-credits 
  2327.                 or  megabytes  when  the  user tries to  exceed  one  of  the 
  2328.                 download limits. 
  2329.                 
  2330.                 
  2331. DOWNLOADING     Users start out with 1 upload byte and 1 download  byte--this 
  2332.                 is to protect from division by zero errors. 
  2333.  
  2334.                 At  the downloading screen,  callers are only able  to  enter 
  2335.                 file names until they reach the end of the line (4  or 5 file 
  2336.                 names).  To do larger "batch" transfers they should use batch 
  2337.                 downloading.  Wildcard's are not allowed. 
  2338.  
  2339.                 Since  the wanted-for-download file names and paths are  sent 
  2340.                 to a file,  whatever protocol we use must be able to read  in 
  2341.                 this file.  The  protocol must accept "@filename.ext"  at the 
  2342.                 end  of  its command line (where filename.ext is our list  of 
  2343.                 file names-currently it is named FNAMES.CTL). 
  2344.  
  2345.                 If  the user selects auto-logoff,  and at least one file  was 
  2346.                 not  sent,   then  auto-logoff is ignored  and  the  user  is 
  2347.                 returned to the system.   That is, if auto-logoff is desired, 
  2348.                 then   at  least  one  file  must  have   been   successfully 
  2349.                 transferred before it will take effect. 
  2350.  
  2351.                 When  downloading,   either bidirectional  or  regular,   the 
  2352.                 software will,  through exchanges,  try to meet their wishes. 
  2353.                 If they wish to download a file, and do not have enough time, 
  2354.                 but plenty of download bytes,  and exchange is done for them, 
  2355.                 giving  them  enough  time,   with reduced bytes  (if  it  is 
  2356.                 possible)--essentially  saving the user the trouble of  doing 
  2357.                 with Exchange.   Exchanges are not done with regular  "daily" 
  2358.                 minute allotments, but with minute-credits. 
  2359.  
  2360.                 Similarly  for  bidirection.   Except the  exchanges  usually 
  2361.                 occur  after  the transfer.   If the user exceeds their  time 
  2362.                 allotment,  then exchanges are done until they are OK again--
  2363.                 this  can  mean  "borrowing"  against  the  future  (negative 
  2364.                 minute-credits).   Should a user with negative minute credits 
  2365.                 (and  few or no download bytes)  try a bidirectional protocol 
  2366.                 again,   he  will  have it limited to  whatever  his  current 
  2367.                 download  minutes  are.   Should his negative minute  credits 
  2368.                 exceed his daily minutes allotment,  then he will not be able 
  2369.                 to  use the bidirectional protocols at all--indeed,   he will 
  2370.                 not be able to download either, only upload. 
  2371.  
  2372.                 Abuse:    It is possible to abuse the system by just  logging 
  2373.                 on, using  a  bidirectional  protocol  for   three  hours  of 
  2374.                 downloading,  then logging off and repeating it with  another 
  2375.                 name.   For this reason I urge you to restrict  bidirectional 
  2376.                 protocols  to  users of levels greater than your first  ("new 
  2377.                 user")  level.   With "validated"  user levels,  no abuse  is 
  2378.                 possible  because ratios are always maintained--even if means 
  2379.                 that  the  user had to go into debt.   Any imbalance  "abuse" 
  2380.                 (such  as doing three hours of downloading)  will be  handled 
  2381.                 the  next  time the user tries to download.   The  system  is 
  2382.                 designed  to be flexible,  but a user who tries to abuse  the 
  2383.                 flexibility  will,  sooner or later,  run into a  wall--which 
  2384.                 will require an upload. 
  2385.  
  2386.                 When a user downloads a free file (as denoted with an "f"  in 
  2387.                 the file listings), the time and size are not counted against 
  2388.                 them,  and  do not appear in their stats at all (it is as  if 
  2389.                 they never  did it).   It does,  however,  appear in the  log 
  2390.                 files  (callers  and  summary).   This is true  even  if  the 
  2391.                 download is aborted midway. 
  2392.                 
  2393.                 When  a download is not completed,  bytes are not  subtracted 
  2394.                 from  the  user's  totals--they  are  only  subtracted   when 
  2395.                 downloads have been completed.   While on the surface it  may 
  2396.                 seem  like abuse is possible (download 90%  of the  file  and 
  2397.                 extract the  remaining  parts with "Work  On  Archives"),  in 
  2398.                 reality it is  too  much  work for  a  user  to  consider  it 
  2399.                 worthwhile (they must use PKZIPFIX for ZIP's,  they must take 
  2400.                 time to calculate where to stop,  and if they screw up,  they 
  2401.                 must repeat the whole process).  I think only one user in two 
  2402.                 years of operation ever attempted this--I just manually added 
  2403.                 the bytes to his record, he never did it again.  Uploading is 
  2404.                 much  easier to do,  and the user needs to have the stats  to 
  2405.                 download the whole file in the first place to even  start the 
  2406.                 transfer.    Finally,   the Exchange system allows  users  to 
  2407.                 maximize their file stats for need: time or bytes--which also 
  2408.                 has the effect to eliminate complex download abuse. 
  2409.  
  2410.                 Free downloads using the "FREE" menu commands do not take off 
  2411.                 time,   or  bytes.  Potentially a user could  just do a large 
  2412.                 free download all day to tie up your system.  If this occurs, 
  2413.                 just  make  the  free file download menu option  with  an  SL 
  2414.                 higher than that of new users. 
  2415.                 
  2416.                 Ultimately,   if  you  find a user is trying  to  abuse  your 
  2417.                 system--tying it up,  calling and hanging up,  etc.   Calling 
  2418.                 the  phone company and  complaining about harassment  is  the 
  2419.                 best way--as the phone company has  the calling logs and will 
  2420.                 be  able  to  see who the caller really is,   and  prove  the 
  2421.                 pattern of abuse. 
  2422.  
  2423.                 Password protected files are handled two ways.  When the file 
  2424.                 name is typed at the downloads-file-name-entry-line they  are 
  2425.                 allowed,   when  the  user completes their entry,   then  the 
  2426.                 question  regarding the password is asked,  and they are only 
  2427.                 allowed to download it if successful.   BiModem does not care 
  2428.                 about  our internal password system,  it has a system of  its 
  2429.                 own with its own password file, you must put in these entries 
  2430.                 manually for BiModem to  protect your password-protect  files 
  2431.                 and your invisible files (since  a  user can find the name of 
  2432.                 an invisible  file   from   the  callers  log--for  long-term 
  2433.                 invisible's,   short  term invisible's have a low  chance  of 
  2434.                 being seen and are not worth the trouble). 
  2435.  
  2436.                 Normally,  SL protection is done at the "get file name"  part 
  2437.                 of  the operation(s).   We check DL SL for the file area  the 
  2438.                 file  is in,  if not enough access,  we pretend it  does  not 
  2439.                 exist.    However,   BiModem  has no method to  stop  a  user 
  2440.                 requesting any  file from any  of  your  "BiModem-accessible" 
  2441.                 defined  areas  (done with BIMODEM.DIR).   Rather,  what  the 
  2442.                 software  relies on to do this is for you to limit access  to 
  2443.                 the  BiModem  protocol  itself to only those  users  who  can 
  2444.                 access all your file areas already. 
  2445.  
  2446.                 Downloading messages (with "MsgD")  and downloading a  Master 
  2447.                 List  (using the internal Master List downloader)   are  also 
  2448.                 free  downloads  (no  bytes/time taken  off).    The  why  is 
  2449.                 obvious:   its faster than if the user did the same  on-line, 
  2450.                 and therefore should be encouraged. 
  2451.                 
  2452.  
  2453. UPLOADING       When a user uploads a file, they are given minute-credits and 
  2454.                 byte-credits.   Both of which are exchangeable for the other. 
  2455.                 Minute-credits  allow  more time for downloading,  and  byte-
  2456.                 credits allow more bytes for downloading. 
  2457.  
  2458. │               You may postpone the giving of these credits until after  you 
  2459. │               validate the file if you wish. 
  2460.  
  2461.                 You   may   only  have  one  file  on-line  with   the   same 
  2462.                 filename.ext.   If the user uploads a file with the same name 
  2463.                 as one that is already on-line, this is known as a duplicate.  
  2464.                 They do not receive credit for uploading duplicates, but they 
  2465.                 will be shown a  note that they should leave you a message to 
  2466.                 get credit.  Then, if the file is original, you should rename 
  2467.                 it,   and  manually give the user their UL bytes and  minute-
  2468.                 credits   for  the  upload.    Whether  your   BBS   renames, 
  2469.                 overwrites,   or rejects duplicates depends on your  protocol 
  2470.                 and what protocol parameters you use. 
  2471.  
  2472.                 Normally,   uploads will be given a "9"  for L&D value,   but 
  2473.                 Targeted  uploads are given only a "2".   If you disable  the 
  2474.                 L&D system then this does not matter. 
  2475.  
  2476.                 Abuse:   the only possible abuse involves logging on  with  a 
  2477.                 phony name,  uploading some duplicate junk,  downloading what 
  2478.                 they  want,   and then next time doing it with another  name.  
  2479.                 This  can  be  avoided by having a  complex  new  user/access 
  2480.                 procedure,   or just requiring uploads to be validated by you 
  2481.                 first. 
  2482.  
  2483.                 If  a user relies on auto-detect ("just does it")  for  their 
  2484.                 upload (for instance, at an ANSI menu), then that upload will 
  2485.                 be put in file area 001  no matter what area they are in now.  
  2486.                 Exceptions to this:  P&S and the paged  method will first try 
  2487.                 to put it  into  the current area.  If the user does not have 
  2488.                 upload  access to area 001,  after not being able to put  the 
  2489.                 upload in the current area, the upload will not be allowed to 
  2490.                 take place. 
  2491.  
  2492.                 After  a upload is done,  there are a variety of  post-upload 
  2493.                 processing  that can be done.   Including:  insertion of  BBS 
  2494.                 comments  into .ZIP and .ARJ files,  extraction to a file  of 
  2495.                 .ZIP  comments,   extraction  of .DIZ  descriptions  to  your 
  2496.                 reviews  files,   and running of a  virus  checking  program.  
  2497.                 These are registered features, however. 
  2498.                 
  2499.                 See also: SETTINGS, TOGGLES, PATHNAMES
  2500.  
  2501. Searching       When a user selects a non-bidirectional protocol,  they  will 
  2502.                 be  asked to enter a search string and a "search the off-line 
  2503.                 lists" will be done.  It is the user's responsibility to make 
  2504.                 sure the software they wish to upload,  is not in your lists.  
  2505.                 You  may toggle this requirement (that they search before all 
  2506.                 uploads) ON/OFF. 
  2507.  
  2508.                 When searching the off-line lists, a text search is done--not 
  2509.                 a  file  name  search.   When a user enters a  string  to  be 
  2510.                 searched for, several processing is done:  all non-alphabetic 
  2511.                 characters are removed and only the resulting "first word" of 
  2512.                 the search string is used. 
  2513.  
  2514.                 If the user enters something common, like "ZIP" or "GIF" then 
  2515.                 they  are refused--too many entries.   The common words  that 
  2516.                 are refused (when entered by themselves) are: ZIP LZH ARJ EXE 
  2517.                 COM  GIF MAC PCX VERSION and PIC.   You may modify these  "no 
  2518.                 no"   search  strings,  just change lines 0350  to  0359   in 
  2519.                 SHORT.TXT. 
  2520.  
  2521.                 If  their search string is one or two characters  in  length, 
  2522.                 they are refused--too many entries. 
  2523.  
  2524.                 If their string contains no vowels,  or a ".",  then they are 
  2525.                 shown a note: "searching for a file name is not recommended". 
  2526.                 Indeed,  the search field is only 10  characters in length to 
  2527.                 discourage searching for file names.  But neither of these is 
  2528.                 discouraging  enough,   the biggest problem  with  this  list 
  2529.                 searching  is  that  users will constantly try  file  names--
  2530.                 rather than the main word of a program's title.   They really 
  2531.                 should  search  for both.   All characters after a  "."   are 
  2532.                 ignored.   Someone should teach these users that there is not 
  2533.                 a law that says that what a file is named on one BBS is named 
  2534.                 on all the BBS's. 
  2535.  
  2536.                 If  uploading (not when doing the menu command to search  the 
  2537.                 lists),  if they  hit [Enter]  before  a search is completed, 
  2538.                 then it is assumed they do not want to upload, and are exited 
  2539.                 back to the menu.   They need only one completed search  in a 
  2540.                 series of searches to move on to the next step and upload the 
  2541.                 program.    This prevents someone from searching part of  the 
  2542.                 search  file,  but not all of it.   Needed,  because the file 
  2543.                 they wish to upload may be in that part of  the list they did 
  2544.                 not see.  If they know the file is not in your list, they can 
  2545.                 just  enter  a "scramble string"  to do  the  fastest  search 
  2546.                 (example: AJKLKAJKL). 
  2547.  
  2548. File            Minute-credits will not be  given  until  the  user  enters a 
  2549. Descriptions    description  for their upload.   This may done later via  the 
  2550.                 Review  system.    Using the file name as  a  description  is 
  2551.                 ignored.    Holding back of minute-credits is the  punishment 
  2552.                 for users not using descriptions.   This software is designed 
  2553.                 to reduce your workload. 
  2554.                 
  2555.                 Users who  have  a  SL greater than  the  lowest  SL you have 
  2556.                 created,   may use "/"  or "\"  as the first character of the 
  2557.                 description to make it a "sysop-only"  file.   This makes the 
  2558.                 file invisible--only the sysop or file-op will be able to see 
  2559.                 it. 
  2560.  
  2561.                 Once  a valid description is given.   The software will check 
  2562.                 to see if the file has a ".GIF" extension.  If it does,  then 
  2563.                 the  dimensions of this GIF are entered into the description. 
  2564.                 GIF dimension entry is automatic for  any  file--it  does not 
  2565.                 matter  what file area the file is in.   Files  which have  a 
  2566.                 ".GIF"   extension  but  are  not  really  GIFs  are  handled 
  2567.                 properly. 
  2568.  
  2569.                 If  censoring is turned on,  then only the file-op of a  file 
  2570.                 area may enter uncensored descriptions. 
  2571.  
  2572.                 All  ANSI codes are stripped out.   The exception to this  is 
  2573.                 when  editing the file's record--then you (the sysop) can use 
  2574.                 ANSI codes.  For color, the " }#word"  system will provide it 
  2575.                 to everyone. 
  2576.  
  2577.                 One  problem  that  seems  to  confound  users  is  uploading 
  2578.                 multiple   files   (batch  upload)    that   have   different 
  2579.                 descriptions.  Since if they enter the description first, all 
  2580.                 files  are  given that description.   To make life easier  on 
  2581.                 them,   you might want to add the text "you will be given the 
  2582.                 chance  to enter individual descriptions after the upload  is 
  2583.                 completed." 
  2584.  
  2585.                 
  2586. REMOVING FILES  There are 3 ways to remove files:   deleting  them  by  hand, 
  2587.                 deleting them with the "oust files"  routines,  and  deleting 
  2588.                 them by using L&D delete. 
  2589.  
  2590.                 Deleting by hand simply involves using DOS's  DEL command. It 
  2591.                 is  what you probably do to delete files on your hard disk or 
  2592.                 floppies that you no longer want.   When doing  this to files 
  2593.                 in your downloads areas,  you should do it before starting up 
  2594.                 the BBS.   If you do delete a file while the  BBS is  running 
  2595.                 (by shelling to DOS or through a door)  then the BBS will not 
  2596.                 know that you deleted it--some routines will still allow that 
  2597.                 file name to be typed,  displaying a  "file not found",   and 
  2598.                 probably confusing your users. 
  2599.  
  2600.                 The  second method,  "ousting files"  via the two sysop  menu 
  2601.                 commands:   Oust Files and Oust Files/Penalty,  or by setting 
  2602.                 the  "1"   attribute with File Maintenance,  will delete  the 
  2603.                 first occurrence of a file.  If you have two  files  with the 
  2604.                 same name, the first file area found to contain the file will 
  2605.                 lose  it--usually  the  uploads  area  is  the  first   area, 
  2606.                 depending upon how you configured your BBS. 
  2607.  
  2608.                 The  difference between Oust Files and Oust Files/Penalty  is 
  2609.                 that  Oust  Files repeatedly loops asking you  for  files  to 
  2610.                 simply delete.   Oust Files/Penalty asks you for a file name, 
  2611.                 finds  out  who uploaded it,  then asks you for a reason  why 
  2612.                 you are deleting it (corrupt,  or a duplicate,  whatever),  a 
  2613.                 message containing your reason and other information is  sent 
  2614.                 by  the  AI  to the user,  and finally  the  file  itself  is 
  2615.                 deleted.   The  text of the AI's message can be  found,   and 
  2616.                 edited, in LINES.TXT. 
  2617.  
  2618.                 The  third method is using the Life & Death system.   When  a 
  2619.                 file's  L&D  count  is  at  zero ("?"),   and  a  variety  of 
  2620.                 conditions  are  met (see L&D menu command)  then a user  may 
  2621.                 choose to "reduce" the L&D value further--delete it. 
  2622.  
  2623.                 With any of these methods,  the deleted file name, size,  and 
  2624.                 description,   are  written  out  to the  log  file  and  the 
  2625.                 ALSO_GOT.LST file. 
  2626.                 
  2627.                 If  you  use  DOS's DEL  command,   then  the  software  will 
  2628.                 recognize the files as missing and consider them deleted.  If 
  2629.                 you should accidentally delete a file,  and then  put it back 
  2630.                 into   any  download  directory,   then  the  software   will 
  2631.                 automatically undelete the file entry for you.  If you should 
  2632.                 only  change  the  extension of a file,   the  software  will 
  2633.                 properly handle that as well. 
  2634.  
  2635.                 When deleting files,  the file is deleted off the hard  disk, 
  2636.                 then  it is  deleted out of memory,  and finally  any reviews 
  2637.                 about that file are removed from the reviews files. 
  2638.  
  2639.                 None  of  the above are as complex as they sound.    I   just 
  2640.                 described  in detail what happens.   Everything is automatic. 
  2641.                 When  you  use DEL you just type a file name.   When you  use 
  2642.                 Oust  Files,  you just type a file name.   When you use  Oust 
  2643.                 Files/Penalty, you just type a file name and a reason (I like 
  2644.                 to keep mine to one word).  With L&D delete you just type the 
  2645.                 file name and a Yes/No confirmation. 
  2646.  
  2647.  
  2648. MISC.           When you get a percentage progress  report:   ▓▓▓█████  (30%) 
  2649.                 Do not worry if it ends at less than 100%,  it may end at 95% 
  2650.                 if the numbers are "just so"  and it may end up much lower if 
  2651.                 there are not that many things to do. 
  2652.  
  2653.                 If  one  gets "No messages found."  when reading logon mail--
  2654.                 after   having   been   promised   mail   ("You   have    the 
  2655.                 following..."),  then this is not a problem.   It is possible 
  2656.                 the  sender  of  the message sent it,  but deleted  it  later 
  2657.                 (before you  called)  or the system deleted it because it was 
  2658.                 too  old  (if circular buffer is in effect)  and  you had not 
  2659.                 called in a long while.  But it usually occurs after you have 
  2660.                 already read your mail, and then went on to somehow crash the 
  2661.                 BBS or used the <alt>x command.
  2662.  
  2663.                 The BBS copies all files from your RAMTEXT directory to  your 
  2664.                 RAM drive when it is run--unless they are the same. 
  2665.  
  2666.                 The  RESULTS  file will still contain my BBS's voting  totals 
  2667.                 and system statistics.   Just run "update system stats"  from 
  2668.                 the sysop menu to eliminate it all. 
  2669.  
  2670.                 The BiModem configuration files were included to aid in setup 
  2671.                 of BiModem.   You still need to go through and make sure  the 
  2672.                 path's and modem type are correct with BICONFIG.COM.
  2673.  
  2674.  
  2675. I AM LOST!?!    If you have gotten to this point,  and you have not tried the 
  2676.                 software yet, you are probably really confused. 
  2677.  
  2678.                 I have given you the architect's designs of the building, but 
  2679.                 all you want is the front door, elevator,  and location of an 
  2680.                 office. 
  2681.  
  2682.                 Toss out BBS2.ARJ--that is the last thing you need now.
  2683.  
  2684.                 Run  the  program,  see what happens,  how  it  works,   etc. 
  2685.                 However,  be aware that a lot does not show up until it is in 
  2686.                 full operation. 
  2687.  
  2688.                 In this  initial configuration,  it is a scaffolding--it  may 
  2689.                 even appear simplistic.
  2690.                 
  2691.                 Do  not  think about what it is,  or what it can  be.    Take 
  2692.                 change a  little at a time.   Look over the stuff you  do not 
  2693.                 know only when you want, or need, to know it. 
  2694.  
  2695.                 This is not a "BBS construction set"--although it can be.
  2696.  
  2697.                 You do not need to be a programmer--although you can be.
  2698.  
  2699.                 YOU decide how "deep"  to get into this software.   Laugh off 
  2700.                 all the  confusing stuff--it can be ignored,  but  it will be 
  2701.                 there when you need it. 
  2702.  
  2703.  
  2704. CUSTOMIZING     You probably have an urge to jump in and start  changing  the 
  2705. 101             menu ANSI's and the menu commands. 
  2706.  
  2707.                 Do not.
  2708.  
  2709.                 Your   first  step  should  be  to  customize  the   internal 
  2710.                 structures  of  the BBS.   This means using  the  sysop  menu 
  2711.                 commands:   Change Settings,  Alter Pathnames,  Toggles,  and 
  2712.                 other Configuration menu commands. 
  2713.  
  2714.                 Indeed,  Toggles  should  be your first  stop--as  it is  the 
  2715.                 easiest.  Then Change Settings.   These modify the limits  of 
  2716.                 your BBS. 
  2717.  
  2718.                 Believe me,  I  know it is complex,  I  must urge you to take 
  2719.                 very small steps in your change-over of the software.  Do not 
  2720.                 read more into what you see, follow the examples, if I do not 
  2721.                 say it cannot work--then you can probably do it. 
  2722.  
  2723.                 See also: SECURITY LEVELS, FILE AREAS, MESSAGE AREAS,
  2724.                           CONVERSION
  2725.  
  2726.  
  2727. TOGGLES         From  the sysop menu,   or  <alt>t  from  Waiting-for-caller, 
  2728.                 brings up the following menu: 
  2729.  
  2730.                 ┌───────────────────────────────────────────────────────────┐
  2731.                 │A. User related toggles.      D. AI's brain.               │
  2732.                 │B. System related toggles.    E. System related toggles 2. │
  2733.                 │C. Message related toggles.                                │
  2734.                 │                                                           │
  2735.                 │Which would you like to alter ([Enter] to quit):           │
  2736.                 └───────────────────────────────────────────────────────────┘
  2737.  
  2738.                 Each option breaks down into a screen of toggles:
  2739.  
  2740.                 ┌─Toggles────────────────────────────────────────────────────────On─────Off────┐
  2741.                 │  A. Users can do Life & Death delete.                                  ▄     │
  2742.                 │  B. Allow new users.                                            ▄            │
  2743.                 │  C. Ask for second name (SysopNote) at first logon.                    ▄     │
  2744.                 │  C. Use the file areas ANSI menu.                                      ▄     │
  2745.                 │  D. Sysop available for chat.                                   ▄            │
  2746.                 │  E. Trap all chat sessions to file.                                    ▄     │
  2747.                 │  F. Users see UserNote at login.                                ▄            │
  2748.                 │  G. Console always shows full callers log.                             ▄     │
  2749.                 │  H. Hacker protect sysops name.                                        ▄     │
  2750.                 │  I. Censor superlatives from descriptions.                      ▄            │
  2751.                 │  J. Censor 'non-words' from messages and descriptions.          ▄            │
  2752.                 │  K. Hang up after phone verifications.                          ▄            │
  2753.                 │  L. Phone verification allows long-distance numbers.                   ▄     │
  2754.                 │  M. All users can use "!" when listing file areas.              ▄            │
  2755.                 │  N. Must search lists before they can upload.                   ▄            │
  2756.                 │  O. Uploads must be validated before giving credit.             ▄            │
  2757.                 └──────────────────────────────────────────────────────────────────────────────┘
  2758.  
  2759.                 Users can do Life & Death delete.
  2760.                      When ON, users may use L&D to actually delete a file.
  2761.  
  2762.                 Allow new users.
  2763.                      When ON,  your BBS will allow new users.   Turn this OFF 
  2764.                      if you do not wish new users.   If OFF, you will need to 
  2765.                      add  user accounts by hand (which involves turning  this 
  2766.                      ON, and logging in locally under the new name). 
  2767.  
  2768.                 Ask for second name (SysopNote) at first logon.
  2769.                      When  ON,   first time callers will be asked for  a real 
  2770.                      name,   in addition to the normal name question.    This 
  2771.                      name will be stored in their SysopNote field. 
  2772.  
  2773.                 Sysop available for chat.
  2774.                      When ON, users will be able to try and chat.
  2775.  
  2776.                 Trap all chat sessions to file.
  2777.                      When  ON,  any chat you do will be trapped to  the  chat 
  2778.                      file. 
  2779.  
  2780.                 Users see UserNote at login.
  2781.                      With the "Logon Note" option, a user may leave a note to 
  2782.                      themselves that appears when they login.   However,  you 
  2783.                      may re-word this  "Logon  Note"   to  use  it to get any 
  2784.                      information  from the user,  which is then kept in their 
  2785.                      UserNote field. 
  2786.  
  2787.                      Information you might want to get:  Self-praise,  street 
  2788.                      address, zip, system type, occupation,  where they heard 
  2789.                      of the board from, amateur radio call sign, etc. 
  2790.  
  2791.                      By  turning this OFF,  you can use it as a second  sysop 
  2792.                      note field. 
  2793.  
  2794.                 Console always shows full callers log.
  2795.                      When On, when a user lists the log,  you will be able to 
  2796.                      see  the  entries that the user cannot at  the console--
  2797.                      otherwise you will just see what they see.  It shows you 
  2798.                      the callers log as you would see if you were logged  on.  
  2799.                      Either way the user does not see the "red" entries. 
  2800.  
  2801.                 Hacker protect sysops name.
  2802.                      When ON, this provides complete protection against users 
  2803.                      hacking at your account. 
  2804.  
  2805.                 Censor superlatives from descriptions.
  2806.                      When ON, words like "excellent"  and "great" will not be 
  2807.                      allowed in the file descriptions. 
  2808.  
  2809.                 Censor 'non-words' from messages and descriptions.
  2810.                      When ON, users will not be able to use words like "alot" 
  2811.                      and "l8tr". 
  2812.  
  2813.                 All users can use "!" when listing file areas.
  2814.                      When  ON,  any user may use "!"  while listing the  file 
  2815.                      area contents to get the secondary information line (who 
  2816.                      uploaded,   etc.)--otherwise only the sysop and  file-op 
  2817.                      can. 
  2818.  
  2819.                 Must search lists before they can upload.
  2820.                      When  ON,  users are required to search the  file  lists 
  2821.                      (specified  in the Search Files database)   before  they 
  2822.                      will be allowed to upload. 
  2823.  
  2824.                 Hang up after phone verifications.
  2825.                      When  ON,  users must call the BBS back if they want  to 
  2826.                      continue  their  session after  passing  call-back/phone 
  2827.                      verification. 
  2828.  
  2829.                      This  is only really needed for long distance calls,  or 
  2830.                      when you are billed for usage. 
  2831.  
  2832.                 Phone verification allows long-distance numbers.
  2833.                      When  ON,  users can enter a long-distance number to  be 
  2834.                      called for call-back/phone verification. 
  2835.  
  2836.                 Uploads must be validated before giving credit.
  2837.                      When  ON,   a  user must wait for the sysop to  validate 
  2838.                      their upload before they will see any download bytes  or 
  2839.                      minutes credit.  When OFF, they are given their download 
  2840.                      bytes and minutes credit immediately after the upload. 
  2841.                      
  2842.                 ┌─Toggles────────────────────────────────────────────────────────On─────Off────┐
  2843.                 │  A. Use BIOS (fast) screen writes.                                     ▄     │
  2844.                 │  B. Keep the screen blank.                                             ▄     │
  2845.                 │  C. You are the next user on.                                          ▄     │
  2846.                 │  E. Show quotes when log off.                                   ▄            │
  2847.                 │  H. Trap all sessions to file.                                         ▄     │
  2848.                 │  I. Expand ANSI's to session trap file.                                ▄     │
  2849.                 │  J. Port has locked baud rate. [door programs use]              ▄            │
  2850.                 │  K. Console commands are accepted.                              ▄            │
  2851.                 │  M. Ask for caller's location at first logon.                   ▄            │
  2852.                 │  N. Allow single-word names (usually 'handles').                ▄            │
  2853.                 │  O. The defined port is a null modem.                                  ▄     │
  2854.                 └──────────────────────────────────────────────────────────────────────────────┘
  2855.  
  2856.                 Use BIOS (fast) screen writes.
  2857.                      When ON, the software will use a combination of BIOS and 
  2858.                      direct  screen writing to speed up display speeds.    It 
  2859.                      doubles the display speed.  However, it is limited where 
  2860.                      it  can  be  used.    It  cannot  be  used  in   graphic 
  2861.                      environments,    multi-window  environments   (such   as 
  2862.                      DesqView) and perhaps under other circumstances.  So try 
  2863.                      it,  if it works,  great,  if not,  you can use /BIOS to 
  2864.                      toggle it OFF when restarting. 
  2865.  
  2866.                      For CGA monitors,  there is still some slight snow  when 
  2867.                      the  screen  clears--but  the speed advantage  makes  it 
  2868.                      worth it. 
  2869.  
  2870.                 Keep the screen blank.
  2871.                      This  is the menu version of the F6  command key.   When 
  2872.                      on,  you  will not see anything--the screen will be kept 
  2873.                      blank. 
  2874.  
  2875.                 You are the next user on.
  2876.                      This  is the menu version of the F5  command key.   When 
  2877.                      ON,   the system will immediately go into console  logon 
  2878.                      mode after the current caller (if you are at this  menu, 
  2879.                      it means after you logoff). 
  2880.  
  2881.                 Show quotes when log off.
  2882.                      When ON, the user is given a quote before hanging up. 
  2883.  
  2884.                 Trap all sessions to file.
  2885.                      When ON,  everything sent to and received from the modem 
  2886.                      is  trapped to a file exactly as it appears--note,  this 
  2887.                      can add up VERY quickly. 
  2888.  
  2889.                      Because  trapping  of the session to disk  slows  things 
  2890.                      down tremendously,  I  recommend you trap to a RAM  disk 
  2891.                      file if you have the memory. 
  2892.  
  2893.                 Expand ANSI's to session trap file.
  2894.                      When trapping a session to a file,  if this is ON,  then 
  2895.                      instead  of  storing the ANSI files it  sends  out,   it 
  2896.                      stores them in the form: ≡≡E:\FILENAME.ANS≡≡. 
  2897.  
  2898.                      Considering that each menu ANSI is like  1k--this  drive 
  2899.                      space savings is significant. 
  2900.  
  2901.                 Port has locked baud rate. [door programs use]
  2902.                      You lock your baud rate in the CONFIG.SYS fossil command 
  2903.                      line.    Setting this toggle,  however,  tells some door 
  2904.                      programs that you have a locked port.   There is nothing 
  2905.                      in the program itself that uses this toggle. 
  2906.  
  2907.                 Console commands are accepted.
  2908.                      When  ON,   commands  such as <alt>t and  the  rest  are 
  2909.                      accepted  from  the  console at  the  waiting-for-caller 
  2910.                      screen  and  when  a user is on.    Otherwise  the  only 
  2911.                      command  allowed  is  <F9>  (logon  locally)   from  the 
  2912.                      waiting-for-caller screen. 
  2913.  
  2914.                 Ask for caller's location at first logon.
  2915.                      Besides  name  and verification,  location is  the  only 
  2916.                      other question a new user is asked.  You can turn it OFF 
  2917.                      if you do not want to ask it then. 
  2918.  
  2919.                 Allow single-word names (usually 'handles').
  2920.                      When ON,  a  user may enter a single word and it will be 
  2921.                      accepted as a valid name.   When OFF,  entering a single 
  2922.                      word is assumed to be only a first name,  and they  will 
  2923.                      be prompted to enter a last name. 
  2924.  
  2925.                 The defined port is a null modem.
  2926.                      If the comm port is a null modem, then turn this ON.  If 
  2927.                      it is a real modem, or the console, then turn this OFF. 
  2928.  
  2929.                      Normally  the toggle is not set here,  but in a "port is 
  2930.                      null  modem  [y/n]"  question after you change the  comm 
  2931.                      port with "Change Settings". 
  2932.                      
  2933.                 ┌─Toggles────────────────────────────────────────────────────────On─────Off────┐
  2934.                 │  D. Grammar Check is installed.                                 ▄            │
  2935.                 │  E. Message-op's can do "%" message files.                             ▄     │
  2936.                 │  F. AI sends a message when penalize.                           ▄            │
  2937.                 └──────────────────────────────────────────────────────────────────────────────┘
  2938.  
  2939.                 Grammar Check is installed.
  2940.                      When  ON,   the system lets users do a Grammar Check  of 
  2941.                      their messages.  When OFF, it is assumed you deleted the 
  2942.                      500k of  WORDS  files so Grammar Check  is not  allowed. 
  2943.                      Note, if you do not want Grammar Check, you will need to 
  2944.                      remove  "}2G}7rammar  Check,"  from  LINES.TXT  for  the 
  2945.                      entering messages command line. 
  2946.  
  2947.                 Message-op's can do "%" message files.
  2948.                      When ON,  message-op's will be able to use "%" to create 
  2949.                      message files which can be accessed via "%%%"  commands.  
  2950.                      Normally, only the sysop can do this. 
  2951.  
  2952.                 AI sends a message when penalize.
  2953.                      When  On,  the AI Oust with Penalty option will  include 
  2954.                      the file name, file size, and a note about what happened 
  2955.                      in a message to the user. 
  2956.  
  2957.                 ┌─Toggles────────────────────────────────────────────────────────On─────Off────┐
  2958.                 │  A. Name detection/completion.                                  ▄            │
  2959.                 │  B. Bytes to/from Minute-Credits when-needed conversion.        ▄            │
  2960.                 │  C. Filename detection/completion.                              ▄            │
  2961.                 │  D. Borrowing from future Minute-Credits.                       ▄            │
  2962.                 │  E. Bytes to Minute-Credits when-needed conversion.             ▄            │
  2963.                 └──────────────────────────────────────────────────────────────────────────────┘
  2964.                 
  2965.                 Name detection/completion.
  2966.                      When ON,  the software will automatically complete names 
  2967.                      as they are entered. 
  2968.  
  2969.                      When  OFF,  the software will still only let users enter 
  2970.                      letters  corresponding to active users,  but it will not 
  2971.                      complete  the  name for them.   If  a  partial  name  is 
  2972.                      entered, then [Enter] is pressed, sometimes the software 
  2973.                      will simply use the full name as if auto-detect was ON. 
  2974.  
  2975.                      Either  way,   login name handling is only a little  bit 
  2976.                      effected,   since it has/had to be much more flexible to 
  2977.                      start with. 
  2978.  
  2979.                 Bytes to/from Minute-Credits when-needed conversion.
  2980.                      When  downloading,   the  software will  attempt  to  do 
  2981.                      exchanges   for  can-download-bytes->minute-credits   or 
  2982.                      minute-credits->can-download-bytes.      This    is    a 
  2983.                      convenience  rather  than the user doing  the  exchanges 
  2984.                      themselves with the Exchange routine. 
  2985.  
  2986.                      When  OFF,  no can-download-bytes will automatically  be 
  2987.                      converted to minute-credits. 
  2988.  
  2989.                      This is only used when selecting files to download.
  2990.                      
  2991.                 Filename detection/completion.
  2992.                      When  ON,  the software will automatically complete file 
  2993.                      names as they are entered. 
  2994.  
  2995.                      When OFF,  it will not complete the file names, but does 
  2996.                      still  restrict  allowable  letters to  files  that  are 
  2997.                      active. 
  2998.  
  2999.                 Borrowing from future Minute-Credits.
  3000.                      When  a  user  exceeds their  time  while  uploading  or 
  3001.                      downloading,   the software will take that  amount  from 
  3002.                      "future"  uploads.   Turning this OFF means users do not 
  3003.                      lose  from future uploads when they exceed their numbers 
  3004.                      (such as when in BiModem). 
  3005.  
  3006.                 Bytes to Minute-Credits when-needed conversion.
  3007.                      When  downloading,   the  software will  attempt  to  do 
  3008.                      exchanges   for  can-download-bytes->minute-credits   or 
  3009.                      minute-credits->can-download-bytes.      This    is    a 
  3010.                      convenience  rather  than the user doing  the  exchanges 
  3011.                      themselves with the Exchange routine. 
  3012.  
  3013.                      When  OFF,   no  minute-credits  will  automatically  be 
  3014.                      converted to can-download-bytes. 
  3015.  
  3016.                 Turning off the AI toggles really does make the software much 
  3017.                 more  simplistic.    These  actions above  were  designed  to 
  3018.                 continue  the  work the users would otherwise have to  do  on 
  3019.                 their own. 
  3020.  
  3021. │               ┌─Toggles────────────────────────────────────────────────────────On─────Off────┐
  3022. │               │  A. Insert text from comment file into uploads.                 ▄            │
  3023. │               │  B. Save archive comments from uploads to a file.               ▄            │
  3024. │               │  C. Last few callers: show current caller.                      ▄            │
  3025. │               │  D. Last few callers: show Console logons.                      ▄            │
  3026. │               │  E. Last few callers: show only for that node.                        ▄      │
  3027. │               │  F. Extract FILE_ID.DIZ into Reviews from uploads.              ▄            │
  3028. │               └──────────────────────────────────────────────────────────────────────────────┘
  3029. │
  3030. │               Insert text from comment file into uploads.
  3031. │                    When ON,  the software automatically insert your  header 
  3032. │                    comment file(s) into .ZIP and .ARJ uploads. 
  3033. │                     
  3034. │               Save archive comments from uploads to a file.
  3035. │                    When  ON,   the software will extract  any  .ZIP  header 
  3036. │                    comments into a text file (so you can view them). 
  3037. │
  3038. │               Last few callers: show current caller.
  3039. │                    When  ON,  the "last few callers"  screen will show  the 
  3040. │                    current caller as the first entry. 
  3041. │
  3042. │               Last few callers: show Console logons.
  3043. │                    When ON,  the "last few callers" screen will include all 
  3044. │                    the "Console" logons.  Turn OFF to hide your logons from 
  3045. │                    the "last few callers" display. 
  3046. │
  3047. │               Last few callers: show only for that node.
  3048. │                    When  ON,   only those who have called the current  node 
  3049. │                    will be shown.   Turn OFF to list the "last few callers" 
  3050. │                    to the BBS--not just one node. 
  3051. │
  3052. │               Extract FILE_ID.DIZ into Reviews from uploads.
  3053. │                    When ON, FILE_ID.DIZ description files will be extracted 
  3054. │                    from uploaded files and their text will be added to  the 
  3055. │                    file reviews file for that upload area. 
  3056.  
  3057.  
  3058. SETTINGS        Selecting "Change Settings"  from the sysop menu,  or  <alt>a 
  3059.                 from  the  waiting-for-caller screen brings up the  following 
  3060.                 menu: 
  3061.  
  3062.                 Changes take effect/are saved when you exit the main settings 
  3063.                 menu. 
  3064.  
  3065.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3066.                 │Those entries with '(restart)' next to them will take effect the next time│
  3067.                 │the BBS is restarted.                                                     │
  3068.                 │                                                                          │
  3069.                 │A. File areas       C. Security levels  E. Other 1                        │
  3070.                 │B. Message areas    D. Space limits     F. Other 2                        │
  3071.                 │                                                                          │
  3072.                 │Which would you like to do ([Enter] to quit):                             │
  3073.                 └──────────────────────────────────────────────────────────────────────────┘
  3074.  
  3075.                 Which in turn break down to the following screens:
  3076.  
  3077.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3078.                 │A. Maximum number of files to keep active at one time:  512               │
  3079.                 │B. Maximum number of files to keep active in any dir (restart):  100      │
  3080.                 │C. Maximum number of FILE_ID.DIZ -> Reviews lines to import:  10          │
  3081.                 │                                                                          │
  3082.                 │Type letter to modify or [Enter] to continue:                             │
  3083.                 └──────────────────────────────────────────────────────────────────────────┘
  3084.  
  3085.                 Maximum number of files to keep active at one time
  3086.                      Maximum number  of  active download file  names you will 
  3087.                      think you will have on-line at one time. 
  3088.  
  3089.                 Maximum number of files to keep active in any dir (restart)
  3090.                      Maximum number  of active download  file  names you will 
  3091.                      think you will  have  on-line  in  any  single  download 
  3092.                      directory at one time. 
  3093.  
  3094.                      Note however,  that this value is also used  elsewhere--
  3095.                      and  if  you run a really large BBS,  you will  probably 
  3096.                      need to increase this. 
  3097.  
  3098.                 Maximum number of FILE_ID.DIZ -> Reviews lines to import
  3099.                      If  you  automatically import  FILE_ID.DIZ  descriptions 
  3100.                      into  your reviews files,  this will limit the number of 
  3101.                      lines imported. 
  3102.  
  3103.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3104.                 │A. Maximum number of messages to keep active at one time (restart):  1,024│
  3105.                 │B. Maximum lines allowed in a message:  99                                │
  3106.                 │C. Maximum characters per message line when reading:  79                  │
  3107.                 │D. The width of news text:  70                                            │
  3108.                 │E. New user MESSAGE.xxx:  001                                             │
  3109.                 │F. Message area for mass mailings:  1                                     │
  3110.                 │G. Maximum number of rambles a user may create per call:  5               │
  3111.                 │H. Maximum number of messages a user may post per call:  10               │
  3112.                 │I. MESSAGE.xxx to inform user he's undergoing peer-review:  003           │
  3113.                 │J. MESSAGE.xxx to inform user he's passed peer-review:  004               │
  3114.                 │K. MESSAGE.xxx to inform user he's failed peer-review:  005               │
  3115.                 │L. Your FidoNet node address is:  0:0/0                                   │
  3116.                 │M. Your FidoNet HUB's node address is:  0:0/0                             │
  3117.                 │N. Maximum number of messages to allow to download at a time:  500        │
  3118.                 │O. Number of lines for each Mini-Note:  5                                 │
  3119.                 │                                                                          │
  3120.                 │Type letter to modify or [Enter] to continue:                             │
  3121.                 └──────────────────────────────────────────────────────────────────────────┘
  3122.  
  3123.                 Maximum number of messages to keep active at one time (restart)
  3124.                      Total  number of messages in all areas to keep active at 
  3125.                      one time. 
  3126.  
  3127.                      As with all these "total active"  fields,  you may  have 
  3128.                      thousands of inactive entries--they do not matter,  only 
  3129.                      the active ones do. 
  3130.  
  3131.                 Maximum lines allowed in a message
  3132.                      Maximum  number of lines to allow in a message.   99  is 
  3133.                      good, as at most it uses 8k of string space.  Internally 
  3134.                      though,  this becomes 16k,  25-30k is the maximum--so if 
  3135.                      you want more lines,play around,  if the system runs out 
  3136.                      of string space, you will know when you have made it too 
  3137.                      large (probably 180 is too big). 
  3138.  
  3139.                      Really, only maximum - 1 lines in a message are allowed. 
  3140.                      The  software  will display line numbers "100"+  in  two 
  3141.                      digits: 00 to 99 (98, 99, 00, 01, etc.)  It looks funny-
  3142.                      -but like I say,  going beyond the 99  limit is risky as 
  3143.                      it simply has not been tested. 
  3144.  
  3145.                 Maximum characters per message line when reading
  3146.                      When reading (and perhaps entering)  messages, it is set 
  3147.                      to  a  width  of  79  characters  now.    But  your  BBS 
  3148.                      personality  may  require  a shorter  or  longer  width.  
  3149.                      Example, if all your users use 132 column modes,  then a 
  3150.                      width of 130 would be OK. 
  3151.  
  3152.                 The width of news text
  3153.                      This  is  the  width of centered  NEWS.    Example:   70 
  3154.                      provides  a 5 character margin on each side of the  news 
  3155.                      text. 
  3156.  
  3157.                 New user MESSAGE.xxx
  3158.                      New  users are sent a message from the AI.    Currently, 
  3159.                      they are sent MESSAGE.001.  However, for example, if you 
  3160.                      were  to change this to "NEW",  then users would be sent 
  3161.                      MESSAGE.NEW. 
  3162.  
  3163.                      Set this to "000" to not send a new user message.
  3164.  
  3165.                 Message base for mass mailings
  3166.                      This is the message base number to use for mass  mailing 
  3167.                      messages.  A 1 corresponds to Private Mail. 
  3168.  
  3169.                 Maximum number of rambles a user may create per call
  3170.                      Just what it says.
  3171.  
  3172.                 Maximum number of messages a user may post per call
  3173.                      Just what it says.
  3174.  
  3175.                 MESSAGE.xxx to inform user he's undergoing peer-review
  3176.                      When  you  use  the "?"  key to send a  user  onto  Peer 
  3177.                      Review, they will be sent this message. 
  3178.  
  3179.                      Use "000" to not send a message.
  3180.  
  3181.                 MESSAGE.xxx to inform user he's passed peer-review
  3182.                      When  a user has passed Peer Review,  they are sent this 
  3183.                      message. 
  3184.  
  3185.                      Use "000" to not send a message.
  3186.  
  3187.                 MESSAGE.xxx to inform user he's failed peer-review
  3188.                      When  a user has failed Peer Review,  they are sent this 
  3189.                      message. 
  3190.  
  3191.                      Use "000" to not send a message.
  3192.  
  3193.                 Your FidoNet node address
  3194.                      This should be FidoNet node address if you have one.
  3195.  
  3196.                 Your FidoNet HUB's node address
  3197.                      This  should be HUB's node address.   Usually this  will 
  3198.                      mean  your FidoNet HUB,  but it should be  whatever  HUB 
  3199.                      address you use.  If you do not use net mail, you do not 
  3200.                      need this. 
  3201.  
  3202.                 Maximum number of messages to allow to download at a time
  3203.                      There  is an internal maximum of 2000  messages that can 
  3204.                      be  downloaded at one time.   But you may set this still 
  3205.                      lower depending on your own preferences. 
  3206.  
  3207.                 Number of lines for each Mini-Note
  3208.                      Mini-Notes will appear in .09.
  3209.  
  3210.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3211.                 │A. Minimum Security Level value to do L&D delete:  20                     │
  3212.                 │B. Minimum SL value needed to make Targeted requests:  20                 │
  3213.                 │C. A Co-sysop is SL value:  99                                            │
  3214.                 │D. Minimum SL value needed to vote:  10                                   │
  3215.                 │E. Minimum SL value needed to add/create a ramble:  10                    │
  3216.                 │F. Minimum SL value to include in Worst Statistics screens:  5            │
  3217.                 │G. Minimum SL value to do bidirectional file transfers:  10               │
  3218.                 │H. Post-Peer Review SL value to give to confirmed user:  5                │
  3219.                 │I. Minimum SL value needed to do peer-reviewing:  20                      │
  3220.                 │J. Maximum SL value allowed to do peer-reviewing:  20                     │
  3221.                 │K. Minimum SL value needed to do sysop-only uploads:  10                  │
  3222.                 │L. SL value to give after successful call-back:  5                        │
  3223.                 │                                                                          │
  3224.                 │Type letter to modify or [Enter] to continue:                             │
  3225.                 └──────────────────────────────────────────────────────────────────────────┘
  3226.  
  3227.                 Minimum Security Level value to do L&D delete
  3228.                      One  uses an SL menu gate for access to L&D.   But  this 
  3229.                      contains  the  minimum SL that is required to do a  file 
  3230.                      delete  with  the L&D system.   There is also  a  Toggle 
  3231.                      which must be set to allow L&D delete. 
  3232.  
  3233.                 Minimum SL value needed to make Targeted requests
  3234.                      The  SL  value needed before users can make requests  of 
  3235.                      each other and Target Upload files to each other. 
  3236.  
  3237.                 A Co-sysop is SL value
  3238.                      The SL value you have decided should be for co-sysops of 
  3239.                      your BBS.  Used only in some door programs.
  3240.  
  3241.                 Minimum SL value needed to vote
  3242.                      The  SL value a user must have to vote.   While you  may 
  3243.                      provide  access  to the voting system for users of a  SL 
  3244.                      with the menu system--their votes will not matter unless 
  3245.                      they have a high enough SL. 
  3246.  
  3247.                 Minimum SL value needed to add/create a ramble
  3248.                      The SL value a user must have in order to start a ramble 
  3249.                      file. 
  3250.  
  3251.                 Minimum SL value to include in Worst Statistics screens
  3252.                      The  SL  value a user must have to get on to  the  worst 
  3253.                      statistics screens.  In general, your lowest level users 
  3254.                      will always have the worst  statistics.   This, and/or a 
  3255.                      minimum  number  of logons,  can eliminate many  of  the 
  3256.                      "deadbeats"   and  show  who is worst among  the  "good" 
  3257.                      users. 
  3258.  
  3259.                 Minimum SL value to do bidirectional file transfers
  3260.                      The   SL  value  a  user  must  have  in  order  to   do 
  3261.                      bidirectional (eg. BiModem) transfers. 
  3262.  
  3263.                 Post-Peer Review SL value to give to confirmed user
  3264.                      After a user passes Peer Review,  they are given this SL 
  3265.                      value. 
  3266.  
  3267.                 Minimum SL value needed to do peer-reviewing
  3268.                      The  minimum SL value a user needs to do a  Peer  Review 
  3269.                      voting on another user. 
  3270.  
  3271.                 Maximum SL value allowed to do peer-reviewing
  3272.                      The  maximum  SL value a user needs to do a Peer  Review 
  3273.                      voting  on  another user.   Useful if you  do  not  want 
  3274.                      fellow sysops to vote on users. 
  3275.  
  3276.                 Minimum SL value needed to do sysop-only uploads
  3277.                      The minimum SL value a user must have in order to have a 
  3278.                      description  starting with a "/"  or "\"  be accepted to 
  3279.                      mean  that the upload is to be for the sysop only,   and 
  3280.                      invisible to all users but the sysop. 
  3281.  
  3282.                 SL value to give after successful call-back
  3283.                      This  is  the security level value to give a user  after 
  3284.                      they successfully pass a call-back verification. 
  3285.  
  3286.                      If set to zero,  then the user's SL value is not changed 
  3287.                      from whatever they have. 
  3288.  
  3289.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3290.                 │A. Minimum drive space needed to do new stuff (Requests/etc.):  8,192     │
  3291.                 │B. Emergency buffer size (number of 4096 increments):  2                  │
  3292.                 │C. Minimum space before AI starts asking for help:  1,000,000             │
  3293.                 │D. Minimum space to allow uploads:  100,000                               │
  3294.                 │E. Minimum space before allow L&D deletes:  1,000,000                     │
  3295.                 │F. Minimum space to allow Targeted upload:  2,000,000                     │
  3296.                 │G. Minimum space at which to stop 'be sure' message:  3,000,000           │
  3297.                 │                                                                          │
  3298.                 │Type letter to modify or [Enter] to continue:                             │
  3299.                 └──────────────────────────────────────────────────────────────────────────┘
  3300.  
  3301.                 Minimum drive space needed to do new stuff (Requests/etc.)
  3302.                      At  various times,  your drive will fill up.    When  it 
  3303.                      reaches the value specified,   the software will not let 
  3304.                      any  "adding"   features  be done  (adding  to  reviews, 
  3305.                      requests,  etc.)  to avoid the risk of filling the drive 
  3306.                      completely and crashing the system. 
  3307.  
  3308.                      When it goes below this amount,  no logging is  done--of 
  3309.                      transfers  or anything else--and no messages are allowed 
  3310.                      to be posted.   However,  if there is enough room for  a 
  3311.                      DSZLOG entry by DSZ or BiModem,  then any user downloads 
  3312.                      will still be handled properly. 
  3313.  
  3314.                 Emergency buffer size (number of 4096 increments)
  3315.                      Emergency drive space (2 here = 8192 bytes).  Typically, 
  3316.                      an upload session can use every last byte on your drive-
  3317.                      -before the protocol aborts due to lack of space.   This 
  3318.                      emergency space is stored in a file.   When an upload is 
  3319.                      done,  if the drive is full,  then this file is deleted, 
  3320.                      freeing  up  space.   This space is needed to do  proper 
  3321.                      logging of the file transfer and other log entries. 
  3322.  
  3323.                      The  amount of emergency drive space should  be  greater 
  3324.                      then  amount of minimum drive space you noted above.--to 
  3325.                      allow further logging. 
  3326.  
  3327.                 Minimum space before AI starts asking for help
  3328.                      If  you  have L&D delete toggled to on,  then  when  the 
  3329.                      drive space falls below this value, the next caller with 
  3330.                      high enough access will be asked by the AI to use  their 
  3331.                      L&D  delete  ability to make space.   This  is  done  at 
  3332.                      logon,   when  they  are  given  a  list  of   potential 
  3333.                      candidates for deletion. 
  3334.  
  3335.                      This  occurs  with the menu command "Asst"  is  in  your 
  3336.                      MENUTEXT.DAT "logon loop".  The command should be set to 
  3337.                      the same SL value used above to allow L&D delete. 
  3338.  
  3339.                 Minimum space to allow uploads
  3340.                      When the drive space falls below this amount,  users are 
  3341.                      not allowed to upload. 
  3342.  
  3343.                 Minimum space before allow L&D deletes
  3344.                      When the drive space falls below this amount,  then  L&D 
  3345.                      delete of a file is allowed, otherwise it is not. 
  3346.  
  3347.                 Minimum space to allow Targeted upload
  3348.                      When  the  drive space falls below  this  amount,   then 
  3349.                      Targeted Upload is not allowed. 
  3350.  
  3351.                 Minimum space at which to stop 'be sure' message
  3352.                      When  uploading,   after the available drive space,   if 
  3353.                      there  is  less than this amount,  then a "be sure it is 
  3354.                      enough" is also displayed. 
  3355.  
  3356.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3357.                 │A. Number of days to maintain the summary log at:  30                     │
  3358.                 │B. Maximum number of users to keep active at one time:  1,024             │
  3359.                 │C. Minimum verification length for lowest level users:  0                 │
  3360.                 │D. Minimum verification length for validated users:  5                    │
  3361.                 │E. Number of minutes of connection before reset:  1                       │
  3362.                 │F. Number of minutes of no connection before reset:  5                    │
  3363.                 │G. Bytes exchange rate:  1,000,000                                        │
  3364.                 │H. Minutes exchange rate:  10                                             │
  3365.                 │I. Penalty (use 200 for 2.00, etc.) multiplier:  200                      │
  3366.                 │J. Maximum verification attempts before hangup:  2                        │
  3367.                 │K. Maximum name attempts before hangup:  3                                │
  3368.                 │L. Minutes of inactivity before a user is timed-out:  4                   │
  3369.                 │M. Minutes of inactivity at logo before disconnect:  1                    │
  3370.                 │N. The size of the stats rankings screen is:  18                          │
  3371.                 │O. Minimum number of logons to include in Worst Statistics:  3            │
  3372.                 │P. Minimum baud rate to avoid BiModem-only day restriction:  0            │
  3373.                 │Q. Pass/fail votes (difference) a Peer Reviewee needs:  5                 │
  3374.                 │                                                                          │
  3375.                 │Type letter to modify or [Enter] to continue:                             │
  3376.                 └──────────────────────────────────────────────────────────────────────────┘
  3377.  
  3378.                 Number of days to maintain the summary log at
  3379.                      This will be implemented in .09.
  3380.  
  3381.                 Maximum number of users to keep active at one time
  3382.                      Total number of active users to maintain at one time. 
  3383.  
  3384.                      When this number is reached,  new users are told to  try 
  3385.                      again  next week.   Their names are not stored and  they 
  3386.                      never get farther than the login screen. 
  3387.  
  3388.                 Minimum verification length for lowest level users
  3389.                      Minimum  verification  length required for  your  lowest 
  3390.                      tier users. 
  3391.  
  3392.                      Using  a  minimum of zero can cause some confusion  with 
  3393.                      new users.   If they stumble into a person's name with a 
  3394.                      zero length password, all they need do is hit [Enter] to 
  3395.                      access the account.  But, one can argue, "anyone who has 
  3396.                      such an easy password deserves...". 
  3397.  
  3398.                 Minimum verification length for validated users
  3399.                      Minimum  verification  length  for everyone  above  your 
  3400.                      lowest tier. 
  3401.  
  3402.                 Number of minutes of connection before reset
  3403.                      After  a  modem connection is made,  how long should  it 
  3404.                      wait (in minutes) for a response/start of session. 
  3405.  
  3406.                 Number of minutes of no connection before reset
  3407.                      After how many minutes of inactivity should we reset the 
  3408.                      modem.  This provides us with security of knowledge that 
  3409.                      no matter what kind of random actions occur,  the system 
  3410.                      is being reset every x minutes. 
  3411.  
  3412.                      It is sort of a security blanket,  you can probably give 
  3413.                      this a high number and forget it exists. 
  3414.  
  3415.                 Bytes exchange rate
  3416.                      Exchange  rate between minute-credits and bytes.    This 
  3417.                      contains how many bytes the exchange is worth. 
  3418.  
  3419.                 Minutes exchange rate
  3420.                      Exchange  rate between minute-credits and bytes.    This 
  3421.                      contains how many minute-credits the exchange is worth. 
  3422.  
  3423.                 Penalty (use 200 for 2.00, etc.) multiplier
  3424.                      When  you  penalize  a user via the  Oust  Files/Penalty 
  3425.                      option, this multiplier determines how much to take off. 
  3426.                      200 for double bytes off (upload bytes * 2), etc. 
  3427.  
  3428.                 Maximum verification attempts before hangup
  3429.                      Number  of wrong verifications allowed before hanging up 
  3430.                      on them. 
  3431.  
  3432.                 Maximum name attempts before hangup
  3433.                      Number of bad name attempts allowed before hanging up on 
  3434.                      them. 
  3435.  
  3436.                 Minutes of inactivity before a user is timed-out
  3437.                      During their session,  number of minutes of inactivity--
  3438.                      when they do not type anything--before we hang them up. 
  3439.  
  3440.                 Minutes of inactivity at logo before disconnect
  3441.                      Before  a  user  actually  logs  in  (during  the  logo, 
  3442.                      shuttle,  etc.)  this determines how long they are given 
  3443.                      before  hanging  up due to inactivity.   This should  be 
  3444.                      short,   since  users with auto-dialers tend  to  forget 
  3445.                      about them and are not around when a user finally  hangs 
  3446.                      up--hanging   up  your  system  yet  again  with   their 
  3447.                      unattended login. 
  3448.  
  3449.                      This  delay is also in effect when the system expects  a 
  3450.                      "quickie" answer (such as Y/N) or when entering a user's 
  3451.                      name (such as at login). 
  3452.  
  3453.                 The size of the stats rankings screen is
  3454.                      The statistical rankings screen size.  18 fits perfectly 
  3455.                      on  a screen,  but you can extend this and the  rankings 
  3456.                      will scroll down when viewed. 
  3457.  
  3458.                      After  changing this,  you must run Update Stats or  you 
  3459.                      will just get nonsense when Stats Display is run. 
  3460.  
  3461.                 Minimum number of logons to include in Worst Statistics
  3462.                      The  minimum number of logons a user must have in  order 
  3463.                      to be considered for the worst stats screens.   Helps to 
  3464.                      eliminate  "non-participatory  and soon to  be  deleted" 
  3465.                      users from clogging up the worst stats screens. 
  3466.  
  3467.                 Minimum baud rate to avoid BiModem-only day restriction
  3468.                      The  minimum baud rate a user needs to have called at to 
  3469.                      not  be  required to follow the BiModem day  rules  ("if 
  3470.                      today  is  BiModem-only  day,  no  other  protocols  are 
  3471.                      allowed"). 
  3472.  
  3473.                      A  user  with a baud greater than or equal to this  will 
  3474.                      not   be  affected  by  BiModem  day.    Actually,   the 
  3475.                      calculation  is:  if CPS rate * 10  >  Baud then  ignore 
  3476.                      BiModem day.  If it does not work properly (for instance 
  3477.                      9600   baud is 960--but you may use a CPS rate of  920--
  3478.                      then just decrease this setting (baud here) until its in 
  3479.                      line (9200  would do).   This setting is just a  number, 
  3480.                      not a real baud rate. 
  3481.  
  3482.                      That  still sounds confusing.   Easier:  if you want  to 
  3483.                      restrict  all callers below 9600  to use BiModem  every-
  3484.                      other-day, then set this value to 8000. 
  3485.  
  3486.                      The  CPS  rate it uses in its calculations  are  derived 
  3487.                      from  your CONNECT strings database.   Which is why I am 
  3488.                      being  so fuzzy here--one sysop may say 890  CPS at 9600 
  3489.                      baud, another may say 1100 CPS. 
  3490.                      
  3491.                      Setting this to 0 turns off BiModem-only days.
  3492.  
  3493.                 Pass/fail votes (difference) a Peer Reviewee needs
  3494.                      The  difference  which  must  be  obtained  for  a  user 
  3495.                      undergoing  Peer  Review  to  either pass  or  fail  the 
  3496.                      process. 
  3497.  
  3498.                      The  difference  is simply the number  of  passed  votes 
  3499.                      greater than the number of failed votes, or vice-versa. 
  3500.  
  3501.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3502.                 │A. Sysop name:  JOHN ROHNER                                               │
  3503.                 │B. Your BBS's phone number is:  414-643-1576                              │
  3504.                 │C. Log leading character(s) for sysop-only info:  |=                      │
  3505.                 │D. Comm port to use (1 = COM1:, etc.):  1                                 │
  3506.                 │E. The current node is:  1                                                │
  3507.                 │F. HiFilePtr value:  1,854                                                │
  3508.                 │G. Show free space on which drives at waiting-for-caller:  CDE            │
  3509.                 │H. Your registration key 1 is:                                            │
  3510.                 │I. Your registration key 2 is:                                            │
  3511.                 │J. Your registration key 3 is:                                            │
  3512.                 │K. First command to execute when a user calls:  STRT                      │
  3513.                 │L. Total number of calls to the BBS so far:  1,221                        │
  3514.                 │M. Maximum baud rate of your modem:  19,200                               │
  3515.                 │N. The size of the last callers screen is:  10                            │
  3516.                 │O. Level/type of logging to do attributes are:  1234567890ABCDEF          │
  3517.                 │                                                                          │
  3518.                 │Type letter to modify or [Enter] to continue:                             │
  3519.                 └──────────────────────────────────────────────────────────────────────────┘
  3520.  
  3521.                 Sysop name
  3522.                      The sysop's name,  used for most things when the sysop's 
  3523.                      name is needed. 
  3524.  
  3525.                 Your BBS's phone number
  3526.                      This  should  be  your BBS's phone  number.    You  must 
  3527.                      include the area code. 
  3528.  
  3529.                      Currently  it is used two ways:  to determine when  long 
  3530.                      distance numbers are long distance or not (for call back 
  3531.                      verification),   and when determining if a net address's 
  3532.                      phone number is a long distance call or not. 
  3533.  
  3534.                 Log leading character(s) for sysop-only info
  3535.                      The  character(s)   to  use in the callers log  file  to 
  3536.                      designate sysop-only-visible entries. 
  3537.  
  3538.                      You may specify up to 5 characters.  Trailing spaces are 
  3539.                      ignored,   leading spaces are kept.   Leaving this blank 
  3540.                      will make all entries visible to everyone. 
  3541.  
  3542.                 Comm port to use (1 = COM1:, etc.)
  3543.                      Use  0 for local-only operation.   Otherwise it  is  the 
  3544.                      port your modem is connected to. 
  3545.  
  3546.                      It asks you if this port is a null modem, answer: No. 
  3547.  
  3548.                      After changing this,  the system will use that comm port 
  3549.                      value when you hang up. 
  3550.  
  3551.                      If  you  accidentally entered the wrong value,  and  you 
  3552.                      have  no  way of accessing that port,   and  the  system 
  3553.                      "freezes" while trying  to access it,  you  should  just 
  3554.                      replace SETTINGS.001 with an older version (backed up or 
  3555.                      from the BBS.ZIP archive.) 
  3556.                      
  3557.                 The current node
  3558.                      For whenever multi-nodal operation is installed.
  3559.  
  3560.                      The current SETTINGS.xxx file is not changed.
  3561.  
  3562.                      A new SETTINGS.xxx (where xxx is the new node value, eg. 
  3563.                      002)   is  created,  and any other settings changes will 
  3564.                      also be put here.  It then "switches"  internally to the 
  3565.                      new  node--using  pathnames  with  the  new  node  value 
  3566.                      instead of the old (so they must exist before you change 
  3567.                      this value). 
  3568.  
  3569.                 HiFilePtr value
  3570.                      HiFilePtr's are line message numbers.   Every time a new 
  3571.                      file is put, or a new review, ramble, or request, is put 
  3572.                      up,   this number in incremented,  and that new item  is 
  3573.                      given  this  value.   It is not really meant  to  be  be 
  3574.                      messed up by you, but I put this in just in case. 
  3575.  
  3576.                      Each user has a HiFilePtr field in their records,  which 
  3577.                      is  then  compared against the current  values  of  each 
  3578.                      item, to find out what is new. 
  3579.  
  3580.                 Show free space on which drives at waiting-for-caller
  3581.                      When at the Waiting-for-caller screen,  it will  display 
  3582.                      the  amount of drive space available on whatever  drives 
  3583.                      you give (up to five). 
  3584.  
  3585.                 Your node address
  3586.                      This  is where your FidoNet node address is  put.    You 
  3587.                      cannot  just create your own,  you must get one from the 
  3588.                      network manager in your area.   To find out who that is, 
  3589.                      ask sysops in your area code who are getting netmail. 
  3590.  
  3591.                      You  do not need a node address to contact other JDR_BBS 
  3592.                      systems. 
  3593.  
  3594.                 Your HUB's node address
  3595.                      This is the node address of your local HUB.   It is used 
  3596.                      when you specify "HUB" in the routing files. 
  3597.  
  3598.                      You  do not need a hub to send mail to other BBS's,  but 
  3599.                      for  long distance calls,  it is usually cheaper to  use 
  3600.                      one. 
  3601.  
  3602.                 Your registration key 1
  3603.                      Registration KEY 1 that you get when you register.
  3604.  
  3605.                      These  keys  are used to decrypt encrypted messages  and 
  3606.                      unlock your registered commands. 
  3607.  
  3608.                 Your registration key 2
  3609.                      Registration KEY 2 that you get when you register.
  3610.  
  3611.                      These  keys  are used to decrypt encrypted messages  and 
  3612.                      unlock your registered commands. 
  3613.  
  3614.                 Your registration key 3
  3615.                      Registration KEY 3 that you get when you register.
  3616.  
  3617.                      These  keys  are used to decrypt encrypted messages  and 
  3618.                      unlock your registered commands. 
  3619.  
  3620.                 First command to execute when a user calls
  3621.                      This is your first menu command to execute.   Usually it 
  3622.                      contains  all the commands you want to do while the user 
  3623.                      is logging in. 
  3624.  
  3625.                 Total number of calls to the BBS so far
  3626.                      This  is  the storage for the total number of  calls  to 
  3627.                      your BBS ever.  It is increased by one with each logon. 
  3628.  
  3629.                 Maximum baud rate of your modem
  3630.                      This  is the speed you wish the software to  communicate 
  3631.                      with  your  modem at.   If your system does not  respond 
  3632.                      when  sending commands such as the modem  initialization 
  3633.                      command, then you should make sure this is correct. 
  3634.  
  3635.                 The size of the last callers screen is
  3636.                      This is the number of users you wish to display for  the 
  3637.                      "show last few callers" screen (at login). 
  3638.  
  3639.                 Level/type of logging to do attributes are
  3640.                      This is also referred to as "LoggingAmount".
  3641.  
  3642.                      It  allows you to turn ON/OFF most all types of logging.  
  3643.                      Below is what each attribute does: 
  3644.  
  3645.                      1  Record each user, or non-user, who calls.
  3646.                      2  Record  each  time a user generates an unwanted  user 
  3647.                         name. 
  3648.                      3  Record each time the BBS is restarted.
  3649.                      4  Record when a wrong password is entered.
  3650.                      5  Record when and which events are executed.
  3651.                      6  Record each time a user changes their password.
  3652.                      7  Record the phone number which with a user passed,  or 
  3653.                         failed, call-back. 
  3654.                         Record when a user passes, or fails, peer review.
  3655.                      8  Record each chat attempt's reason.
  3656.                      9  Record when a user has been penalized,  and what  the 
  3657.                         file was. 
  3658.                      0  Record when you have deleted a user.
  3659.                      A  Record  file transfers (copied straight from protocol 
  3660.                         log). 
  3661.                      B  Record net mail stuff.
  3662.                      C  Record when a file is removed/deleted/disappeared.
  3663.                      D  Record when do a minor fix to a file or message entry 
  3664.                         (adjustments). 
  3665.                      E  Record what was purged in purging operations.
  3666.                      F  Do internal error checking after each command.
  3667.  
  3668.                      "F" does internal checks after each command to check for 
  3669.                      internal   (programming)    errors  such   as:    handle 
  3670.                      mismatches, low string space, string space corruption, a 
  3671.                      left-over TEMPFILE, etc. 
  3672.                      
  3673.                 Those  with  "(restart)"   in them requires that the  BBS  be 
  3674.                 exited and  restarted  again before they  will  take  effect.  
  3675.                 These  represent  arrays--that  use memory--so bigger is  not 
  3676.                 always better. 
  3677.  
  3678.  
  3679. PATHNAMES       Selecting "Alter Pathnames" from the sysop menu brings up the 
  3680.                 following menu: 
  3681.  
  3682.                 Be  sure the pathnames you give are correct--as the  software 
  3683.                 does  not complain when it cannot find a pathname.   And  the 
  3684.                 errors  you  get may be subtle.   When using  "LoggingAmount" 
  3685.                 (see SETTINGS) with the "F"  attribute (watchful diagnostics) 
  3686.                 ON, if you get "handle mismatch" in the ERRORS.LOG file, then 
  3687.                 it is usually because of a wrong pathname. 
  3688.  
  3689.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3690.                 │A. Drive Paths   D. File names 3  G. File names 6                         │
  3691.                 │B. File names 1  E. File names 4  H. File names 7                         │
  3692.                 │C. File names 2  F. File names 5                                          │
  3693.                 │                                                                          │
  3694.                 │Which would you like to do ([Enter] to quit):                             │
  3695.                 └──────────────────────────────────────────────────────────────────────────┘
  3696.  
  3697.                 Which in turn break down to the following screens:
  3698.  
  3699.                 However,   BE THEE WARNED:  the pathnames displayed  on  your 
  3700.                 screen will always be the "post-processed"  pathnames.  AFTER 
  3701.                 they  had  their  "???"'s  and  RAM  Drive  equivalent  paths 
  3702.                 changed.  But when you change it, feel free to use "???"'s if 
  3703.                 you   want--they   too  will  show   up   as   post-processed 
  3704.                 equivalents.  In other words, where I have "c:\bbs\node.???\" 
  3705.                 you  will  see "c:\bbs\node.001\"  even though it  is  really 
  3706.                 stored as "c:\bbs\node.???\". 
  3707.  
  3708.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3709.                 │A.            BBS/main/uploads drive:  C:\                                │
  3710.                 │B.                  Primary BBS path:  C:\BBS\                            │
  3711.                 │C.  Path of files to go to RAM drive:  C:\BBS\NODE.???\RAMDRIVE\          │
  3712.                 │D.                         RAM drive:  E:\                                │
  3713.                 │E.            Path for file attaches:  C:\BBS\GLOBAL\MSGSTUFF\            │
  3714.                 │F.    Path containing the text files:  C:\BBS\GLOBAL\TEXT\                │
  3715.                 │I.         Path for extracting files:  C:\BBS\NODE.???\TEMPAREA\          │
  3716.                 │                                                                          │
  3717.                 │Type letter to modify or [Enter] to continue:                             │
  3718.                 └──────────────────────────────────────────────────────────────────────────┘
  3719.  
  3720.                 These are the paths the BBS shall use.   "d:\"  is determined 
  3721.                 when you run the program for the first time. 
  3722.  
  3723.                 When you change one of these entries,  the directory will  be 
  3724.                 created if it does not already exist. 
  3725.  
  3726.                 BBS/main/uploads drive
  3727.                      This is your primary drive.   It should be the drive  in 
  3728.                      which most of your BBS files--certainly those files that 
  3729.                      are changeable--and your primary upload drive. 
  3730.  
  3731.                 Primary BBS path
  3732.                      This is the path out of which you run JDR_BBS, it should 
  3733.                      contain the batch files. 
  3734.  
  3735.                 Path of files to go to RAM drive
  3736.                      This is the path to your primary ANSI files (or anything 
  3737.                      else) that you want to put in a RAM disk at startup. 
  3738.  
  3739.                      If your RAM drive is "E:\" you will usually see an "E:\"
  3740.                      here also.
  3741.  
  3742.                 RAM drive
  3743.                      This  defines  where that RAM drive is,  if the same  as 
  3744.                      "Path  of  files to go to RAM drive:"  then its  assumed 
  3745.                      you are  not using a RAM drive--in which case  the files 
  3746.                      will not be copied over. 
  3747.  
  3748.                      Change this to your RAM drive (eg. "E:\").  It will take 
  3749.                      effect  the next time you start the BBS.   There  is  no 
  3750.                      need to go through and change every pathname you wish to 
  3751.                      be on the RAM drive; change this to what you want,  then 
  3752.                      exit and restart the BBS. 
  3753.  
  3754.                 Path for file attaches
  3755.                      This is the directory where file attaches will be put.
  3756.  
  3757.                      File  attaches are stored in this directory under  their 
  3758.                      own    directory    corresponding   to   the    formula: 
  3759.                      MessageNumber.MessageArea   Example:  message  5000   in 
  3760.                      Private  Mail  (area  001)   has  its  files  stored  in 
  3761.                      \MSGSTUFF\5000.001. 
  3762.  
  3763.                 Path containing the text files
  3764.                      This  is the path to the BBS's files that can be  edited 
  3765.                      with a text editor.  Except for MESSAGE.xxx files, these 
  3766.                      are files you or your users create. 
  3767.  
  3768.                 Path for extracting files
  3769.                      When  we wish to extract a file,  to again compress into 
  3770.                      EXTRACT.ZIP,   this  is  where the extracted  files  are 
  3771.                      temporarily stored. 
  3772.  
  3773.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3774.                 │A.               Users data pathname:  C:\BBS\GLOBAL\SYSTEM\USERS         │
  3775.                 │B.     Message headers data pathname:  C:\BBS\GLOBAL\SYSTEM\MESSAGES.HDR  │
  3776.                 │C.        User message data pathname:  C:\BBS\GLOBAL\SYSTEM\USERMSGS      │
  3777.                 │D.        Files information pathname:  C:\BBS\GLOBAL\SYSTEM\FILELIST      │
  3778.                 │E.  Peer Review voting data pathname:  C:\BBS\GLOBAL\SYSTEM\PEERREVW      │
  3779.                 │F.          "Lines" of text pathname:  C:\BBS\NODE.???\LINES.TXT          │
  3780.                 │G.         "Blocks" of text pathname:  C:\BBS\NODE.???\BLOCKS.TXT         │
  3781.                 │H.                Filenames pathname:  C:\BBS\GLOBAL\SYSTEM\FNAMES        │
  3782.                 │I.            Spell words file names:  C:\BBS\GLOBAL\GRAMMAR\WORDS        │
  3783.                 │J.           Temporary work pathname:  C:\BBS\NODE.???\TEMPAREA\TEMPFILE  │
  3784.                 │K.          Emergency space pathname:  C:\BBS\GLOBAL\SYSTEM\8192.BUF      │
  3785.                 │L.             LINES image pathnames:  C:\BBS\NODE.???\RAMDRIVE\LINES.$$$ │
  3786.                 │M.       Results/stats info pathname:  C:\BBS\GLOBAL\SYSTEM\RESULTS       │
  3787.                 │N.                 Requests pathname:  C:\BBS\GLOBAL\TEXT\REQUESTS.TXT    │
  3788.                 │O.                Reviews file names:  C:\BBS\GLOBAL\TEXT\REVIEWS.        │
  3789.                 │P.              BBS Reviews pathname:  C:\BBS\GLOBAL\TEXT\BBSREV.TXT      │
  3790.                 │Q.            Skills/fields pathname:  C:\BBS\GLOBAL\TEXT\SKILLS.TXT      │
  3791.                 │                                                                          │
  3792.                 │Type letter to modify or [Enter] to continue:                             │
  3793.                 └──────────────────────────────────────────────────────────────────────────┘
  3794.  
  3795.                 Users data pathname
  3796.                      This file contains the users records.
  3797.  
  3798.                 Message headers data pathname
  3799.                      This  file  contains  the  message  header  records  and 
  3800.                      message text. 
  3801.  
  3802.                 User message data pathname
  3803.                      This  file contains the information about message  bases 
  3804.                      and  users.   High message read,  toggle status,  access 
  3805.                      status, and messages waiting. 
  3806.  
  3807.                 Files information pathname
  3808.                      This file contains the file records for all downloadable 
  3809.                      files. 
  3810.  
  3811.                 Peer Review voting data pathname
  3812.                      This  file  contains information on which users  already 
  3813.                      voted for which peer review. 
  3814.  
  3815.                 "Lines" of text pathname
  3816.                      This  file  contains most of the text the BBS  uses  for 
  3817.                      everything.  You may edit what you do not like. 
  3818.  
  3819.                 "Blocks" of text pathname
  3820.                      This  file  contains text that is larger than  a  single 
  3821.                      line, DataBaser definition blocks, menu blocks. 
  3822.  
  3823.                 Filenames pathname
  3824.                      This file contains the first 8 letters of all files that 
  3825.                      have been uploaded to the BBS.  It will be part of check 
  3826.                      on-line lists and duplicate upload checking routines for 
  3827.                      the future. 
  3828.  
  3829.                 Spell words file names
  3830.                      These  files  contain the words for  the  Grammar  Check 
  3831.                      message spell checker. 
  3832.  
  3833.                 Temporary work pathname
  3834.                      This  is a temporary work file,  used for a  variety  of 
  3835.                      things.  Do not give it an extension--to create multiple 
  3836.                      temporary  files  the software attaches an extension  to 
  3837.                      this name. 
  3838.  
  3839.                 Emergency space pathname
  3840.                      This is the name of the BBS's emergency space file,  for 
  3841.                      when an uploader uses up all the drive space. 
  3842.  
  3843.                 LINES image pathname
  3844.                      This is a system created file.  It is a slightly smaller 
  3845.                      version of LINES.TXT.  It is this file that the software 
  3846.                      will copy to a RAM disk. 
  3847.  
  3848.                 Results/stats info pathname
  3849.                      This  file stores the system configuration  information, 
  3850.                      the  voting results,  and the information for the  stats 
  3851.                      screens. 
  3852.  
  3853.                 Requests pathname
  3854.                      This file contains file requests by you and your users. 
  3855.  
  3856.                 Reviews file names
  3857.                      This file contains file reviews by you and your users. 
  3858.  
  3859.                 BBS Reviews pathname
  3860.                      This file contains reviews of other BBS's.
  3861.  
  3862.                 Skills/fields pathname
  3863.                      This  file contains the jobs/professions of you and your 
  3864.                      users. 
  3865.  
  3866.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3867.                 │A.     Linkages information pathname:  C:\BBS\GLOBAL\SYSTEM\LINKAGES.DAT  │
  3868.                 │B. Files-to-search database pathname:  C:\BBS\GLOBAL\SYSTEM\SEARCH.DAT    │
  3869.                 │C.   File areas definitions pathname:  C:\BBS\GLOBAL\SYSTEM\FILEAREA.DAT  │
  3870.                 │D.         Voting questions pathname:  C:\BBS\GLOBAL\TEXT\VOTE.TXT        │
  3871.                 │E.                   Quotes pathname:  C:\BBS\GLOBAL\TEXT\GOODBYE.TXT     │
  3872.                 │F.                    News pathnames:  C:\BBS\GLOBAL\TEXT\NEWS.           │
  3873.                 │G.      'Already have' list pathname:  C:\BBS\ALSO_GOT.LST                │
  3874.                 │H.              Callers log pathname:  C:\BBS\NODE.???\CALLERS.LOG        │
  3875.                 │I.             Caller stats pathname:  C:\BBS\GLOBAL\SYSTEM\SUMMARY.DAT   │
  3876.                 │J.                DSZ's log pathname:  C:\BBS\DSZLOG                      │
  3877.                 │K.           DSZ executable pathname:  C:\BBS\DSZ.EXE                     │
  3878.                 │L.               Errors log pathname:  C:\BBS\ERRORS.LOG                  │
  3879.                 │M.         PKZIP executable pathname:  C:\BBS\PKZIP.EXE                   │
  3880.                 │N.       PKUNZIP executable pathname:  C:\BBS\PKUNZIP.EXE                 │
  3881.                 │O.           LHA executable pathname:  C:\BBS\LHA.EXE                     │
  3882.                 │P.           ARJ executable pathname:  C:\BBS\ARJ.EXE                     │
  3883.                 │Q.        Paths information pathname:  C:\BBS\PATHS.DAT                   │
  3884.                 │                                                                          │
  3885.                 │Type letter to modify or [Enter] to continue:                             │
  3886.                 └──────────────────────────────────────────────────────────────────────────┘
  3887.  
  3888.                 Linkages information pathname
  3889.                      This  file contains information on whose linked  to  who 
  3890.                      for  "download support".   If you change this name,  you 
  3891.                      should also change the name in BLOCKS.TXT block 08. 
  3892.  
  3893.                 Files-to-search database pathname
  3894.                      This  file  contains the file names of files  to  search 
  3895.                      when  a  user does an off-line  search--such  as  before 
  3896.                      uploading. 
  3897.  
  3898.                 File areas definitions database
  3899.                      This file contains information about your file areas.
  3900.  
  3901.                      See also: FILE AREAS
  3902.  
  3903.                 Voting questions pathname
  3904.                      This file contains your voting questions and options.
  3905.  
  3906.                 Quotes pathname
  3907.                      This file contains quotes.
  3908.  
  3909.                 News pathnames
  3910.                      This file contains news items for when log on.
  3911.  
  3912.                 'Already have' list pathname
  3913.                      This file contains the file name, size, and description, 
  3914.                      of  files you already had up on the BBS--and do not want 
  3915.                      users to put up again. 
  3916.  
  3917.                 Callers log pathname
  3918.                      This  is  the  logging  file,  it  holds  a  variety  of 
  3919.                      information.  Delete it when it gets too big. 
  3920.  
  3921.                 Caller stats pathname
  3922.                      This  file  contains  information  on  each  caller  for 
  3923.                      statistical stuff. 
  3924.  
  3925.                 DSZ's log pathname
  3926.                      Path to DSZ's log file.  Used with net mail transfers.
  3927.  
  3928.                 DSZ executable pathname
  3929.                      Path to DSZ program.  Used with net mail transfers.
  3930.  
  3931.                 Errors log pathname
  3932.                      This  file  contains various error and  file  adjustment 
  3933.                      reports. 
  3934.  
  3935.                 PKZIP executable pathname
  3936.                      Path to PKZIP program.
  3937.  
  3938.                 PKUNZIP executable pathname
  3939.                      Path to PKUNZIP program.
  3940.  
  3941.                 LHA executable pathname
  3942.                      Path to LHA program.
  3943.  
  3944.                 ARJ executable pathname
  3945.                      Path to ARJ program.
  3946.  
  3947.                 Paths information pathname                                     
  3948.                      This   file  contains  the  path  information  that   is 
  3949.                      displayed on these screens. 
  3950.  
  3951.                 ┌──────────────────────────────────────────────────────────────────────────┐
  3952.                 │A.      Message area index pathnames:  C:\BBS\GLOBAL\INDEXES\MSGS_        │
  3953.                 │B.       Database of sysops pathname:  C:\BBS\GLOBAL\SYSTEM\SYSOPS.DAT    │
  3954.                 │C.        Database of doors pathname:  C:\BBS\GLOBAL\SYSTEM\DOORS.DAT     │
  3955.                 │D.        Message area info pathname:  C:\BBS\GLOBAL\SYSTEM\MSGBASES.DAT  │
  3956.                 │E.                Message file names:  C:\BBS\GLOBAL\MSGSTUFF\MESSAGE.    │
  3957.                 │F.             Backup batch pathname:  C:\BBS\BACKUP.BAT                  │
  3958.                 │G.         Deleted messages pathname:  C:\BBS\DEL_MSGS.TXT                │
  3959.                 │H.           Higher access pathnames:  C:\BBS\NODE.???\ANSI\ACCESS        │
  3960.                 │I.    Ramblings information pathname:  C:\BBS\GLOBAL\SYSTEM\RAMBLING.DAT  │
  3961.                 │J.           Directry data pathnames:  C:\BBS\GLOBAL\TEXT\DIRECTRY.D      │
  3962.                 │K.          Directry title pathnames:  C:\BBS\GLOBAL\TEXT\DIRECTRY.T      │
  3963.                 │L.          Directry index pathnames:  C:\BBS\GLOBAL\INDEXES\DIRECTRY.I   │
  3964.                 │M.    Survey/questionnaire pathnames:  C:\BBS\GLOBAL\TEXT\SURVEY.         │
  3965.                 │N.           Survey answer pathnames:  C:\BBS\GLOBAL\TEXT\ANSWERS.        │
  3966.                 │O.         UL/DL files list pathname:  C:\BBS\NODE.???\FNAMES.CTL         │
  3967.                 │Q.                 Trap All pathname:  C:\BBS\SESSION.LOG                 │
  3968.                 │                                                                          │
  3969.                 │Type letter to modify or [Enter] to continue:                             │
  3970.                 └──────────────────────────────────────────────────────────────────────────┘
  3971.  
  3972.                 Message area index pathnames
  3973.                      These  files  contain the index data  for  each  message 
  3974.                      area. 
  3975.                      
  3976.                 Database of sysops pathname
  3977.                      This  file  contains information on other BBS's that you 
  3978.                      call.   If you change this name,  you will also  need to 
  3979.                      change block 09 in BLOCKS.TXT. 
  3980.  
  3981.                 Database of doors pathname
  3982.                      This  file contains information about your door programs 
  3983.                      you wish to run.  If you change this name, you will also 
  3984.                      need to change block 38 in BLOCKS.TXT. 
  3985.  
  3986.                 Message area info pathname
  3987.                      This file contains information about your message areas. 
  3988.                      If you  change this name,  you will also need  to change 
  3989.                      block 10 in BLOCKS.TXT. 
  3990.  
  3991.                 Message file names
  3992.                      These  files are created when you use the "%"   command. 
  3993.                      They are message files, accessible in other messages via 
  3994.                      the "%%%xxx" command. 
  3995.  
  3996.                 Backup batch pathname
  3997.                      This  is only used to create your backup batch file when 
  3998.                      you first set up the BBS. 
  3999.  
  4000.                 Deleted messages pathname
  4001.                      When packing, this file gets your deleted messages.   It 
  4002.                      also gets a copy of the deleted rambles. 
  4003.  
  4004.                 Higher access pathnames
  4005.                      This is a pathnames fragment.   A  "*.*"  is attached to 
  4006.                      its  end,   and  all file names matching  the  resulting 
  4007.                      wildcard will be considered. 
  4008.  
  4009.                      These  files are for the "Ninf"  command--higher  access 
  4010.                      ANSI screens. 
  4011.  
  4012.                 Ramblings information pathname
  4013.                      This  file  contains the information about what  rambles 
  4014.                      are available. 
  4015.  
  4016.                 Directry data pathnames
  4017.                      These files contain the text for the "directry" system's 
  4018.                      entries you create. 
  4019.  
  4020.                 Directry title pathnames
  4021.                      These  files  contain  the  titles  for  the  "directry" 
  4022.                      system's entries you create. 
  4023.  
  4024.                 Directry index pathnames
  4025.                      These  files  contain an index off all the entries in  a 
  4026.                      "directry" systems you create. 
  4027.  
  4028.                 Survey/questionnaire pathnames
  4029.                      These files contain the questionnaires. 
  4030.  
  4031.                 Survey answer pathnames
  4032.                      These files contain the answers to the questionnaires. 
  4033.  
  4034.                 UL/DL files list pathname
  4035.                      This  file  contains  the pathnames of  any  files  just 
  4036.                      downloaded  (if a download only session)  or those  just 
  4037.                      uploaded (if a upload only or bidirectional session). 
  4038.  
  4039.                      The file exists until the next file transfer.
  4040.  
  4041.                      For  "download only"  protocols this file  will  contain 
  4042.                      files  selected  (they  may or may not  have  been  sent 
  4043.                      successfully),  for uploads and bidirectional protocols, 
  4044.                      it will contain files received successfully, but not any 
  4045.                      of the files that were sent. 
  4046.  
  4047.                 Trap All pathname
  4048.                      When you have trapping of everything to a log file, this 
  4049.                      is the file where it is all stored. 
  4050.  
  4051.                 ┌──────────────────────────────────────────────────────────────────────────┐
  4052.                 │A.                Trap Chat pathname:  C:\BBS\CHAT.LOG                    │
  4053.                 │B.           Rambling text pathnames:  C:\BBS\GLOBAL\TEXT\RAMBLING.       │
  4054.                 │C.               Door batch pathname:  C:\BBS\DOOR???.BAT                 │
  4055.                 │D.                BBS batch pathname:  C:\BBS\BBS???.BAT                  │
  4056.                 │E.              Users index pathname:  C:\BBS\GLOBAL\INDEXES\USERS.IDX    │
  4057.                 │G. ANSI file to display to new users:  C:\BBS\NODE.???\ANSI\NEWUSER.ANS   │
  4058.                 │H.              Files index pathname:  C:\BBS\GLOBAL\INDEXES\FILES.IDX    │
  4059.                 │I.            Short strings pathname:  C:\BBS\GLOBAL\TEXT\SHORT.TXT       │
  4060.                 │J.             LINES index pathnames:  C:\BBS\NODE.???\LINES.IDX          │
  4061.                 │K.            BLOCKS index pathnames:  C:\BBS\NODE.???\BLOCKS.IDX         │
  4062.                 │O.   Any user's first profile screen:  C:\BBS\NODE.???\ANSI\PROFILE3.ANS  │
  4063.                 │P.  Any user's second profile screen:  C:\BBS\NODE.???\ANSI\PROFILE4.ANS  │
  4064.                 │                                                                          │
  4065.                 │Type letter to modify or [Enter] to continue:                             │
  4066.                 └──────────────────────────────────────────────────────────────────────────┘
  4067.  
  4068.                 Trap Chat pathname
  4069.                      When you have trapping of chat sessions on,  this is the 
  4070.                      file where it is all stored. 
  4071.  
  4072.                 Rambling text pathnames
  4073.                      These files store the text for the rambling topics. 
  4074.  
  4075.                 Door batch pathname
  4076.                      This file is run when executing a door. 
  4077.  
  4078.                 BBS batch pathname
  4079.                      This file is run when executing the BBS. 
  4080.  
  4081.                 Users index pathname
  4082.                      This file contains index data for the user records. 
  4083.                      
  4084.                 ANSI file to display to new users
  4085.                      This ANSI is shown to new users when they first logon.
  4086.  
  4087.                 Files index pathname
  4088.                      This  file  contains index data for the  download  files 
  4089.                      records. 
  4090.  
  4091.                 Short strings pathname
  4092.                      This file contains really short strings of text that are 
  4093.                      to be loaded to memory. 
  4094.  
  4095.                 LINES index pathname
  4096.                      This  file contains index data for the LINES.$$$   image 
  4097.                      file. 
  4098.  
  4099.                 BLOCKS index pathname
  4100.                      This file contains index data for the BLOCKS.TXT file.
  4101.                      
  4102.                 Any user's first profile screen
  4103.                      This is the template ANSI that is first  displayed  with 
  4104.                      the "ProA" menu command. 
  4105.  
  4106.                 Any user's second profile screen
  4107.                      This  is  the  template ANSI that is secondly  displayed 
  4108.                      with the "ProB" menu command. 
  4109.  
  4110.                 ┌──────────────────────────────────────────────────────────────────────────┐
  4111.                 │A.        Protocol database pathname:  C:\BBS\GLOBAL\SYSTEM\PROTOCOL.DAT  │
  4112.                 │B.         Routing database pathname:  C:\BBS\GLOBAL\SYSTEM\ROUTING.DAT   │
  4113.                 │C.  Security level database pathname:  C:\BBS\GLOBAL\SYSTEM\SL.DAT        │
  4114.                 │D.          Events database pathname:  C:\BBS\GLOBAL\SYSTEM\EVENTS.DAT    │
  4115.                 │E.          Messages bodies pathname:  C:\BBS\GLOBAL\SYSTEM\MESSAGES.BDY  │
  4116.                 │F.    Modem CONNECT strings pathname:  C:\BBS\GLOBAL\SYSTEM\CONNECT.DAT   │
  4117.                 │G. Node-dependent settings pathnames:  C:\BBS\GLOBAL\SYSTEM\SETTINGS.???  │
  4118.                 │I. Message compression and menu info:  C:\BBS\GLOBAL\SYSTEM\INTERNAL.TXT  │
  4119.                 │J.       Names to not allow to login:  C:\BBS\GLOBAL\TEXT\NOTNAMES.TXT    │
  4120.                 │K.        Comment file for ZIP/ARJ's:  C:\BBS\GLOBAL\TEXT\COMMENT.TXT     │
  4121.                 │L.  Message downloading storage file:  C:\BBS\NODE.???\TEMPAREA\MESSAGES.TXT│(oop's)
  4122.                 │M.  Menu commands structure pathname:  C:\BBS\NODE.???\MENUS.DAT          │
  4123.                 │N.       Command categories pathname:  C:\BBS\GLOBAL\SYSTEM\CATEGORY.DAT  │
  4124.                 │O.      Command definitions pathname:  C:\BBS\GLOBAL\SYSTEM\CMDS.DAT      │
  4125.                 │P.Menu commands definitions pathname:  C:\BBS\NODE.???\BBS_CMDS.DAT       │
  4126.                 │Q.          Special effects pathname:  C:\BBS\NODE.???\FX.TXT             │
  4127.                 │                                                                          │
  4128.                 │Type letter to modify or [Enter] to continue:                             │
  4129.                 └──────────────────────────────────────────────────────────────────────────┘
  4130.  
  4131.                 Protocol database pathname
  4132.                      This file contains the protocols your users are able  to 
  4133.                      use. 
  4134.  
  4135.                      If you change this name, you should also change the name 
  4136.                      in BLOCKS.TXT block 47. 
  4137.  
  4138.                 Routing database pathname
  4139.                      This file contains routing ("where to send") information 
  4140.                      for your EchoMail message areas. 
  4141.  
  4142.                 Security level database pathname
  4143.                      This file contains your security level information.
  4144.  
  4145.                      If you change this name, you should also change the name 
  4146.                      in block 42 in BLOCKS.TXT. 
  4147.  
  4148.                 Events database pathname
  4149.                      This file contains your events information.
  4150.  
  4151.                      If you change this name, you should also change block 39 
  4152.                      in BLOCKS.TXT. 
  4153.  
  4154.                 Messages bodies pathname
  4155.                      This file contains the actual message text. 
  4156.  
  4157.                 Modem CONNECT strings pathname
  4158.                      The modem CONNECT strings your modem sends out.
  4159.  
  4160.                      If you change this name, you should also change block 55
  4161.                      in BLOCKS.TXT.
  4162.  
  4163.                 Node-dependent settings pathnames
  4164.                      This file stores the settings information for each  node 
  4165.                      you create. 
  4166.  
  4167.                 Message compression and menu info
  4168.                      This file contains the message compression information. 
  4169.  
  4170.                 Names to not allow to login
  4171.                      This  file should contain names/words you do not wish to 
  4172.                      allow to logon on. 
  4173.  
  4174.                      Each line should contain one "checker" word/name.   That 
  4175.                      is,  when the user is entering their name during  login, 
  4176.                      they  will have their first name,  last name,  and  full 
  4177.                      name compared against each line of this file.   If there 
  4178.                      is a match, they are asked to enter another name. 
  4179.  
  4180.                      The  file  is only checked when a caller  hits  [Enter].  
  4181.                      This means if you have "SYSOP SYSOP" on a line,  and the 
  4182.                      user enters "SYSOP<ret>"  it will not be caught,  but if 
  4183.                      the     caller    enters    "SYSOP    SYSOP<ret>"     or 
  4184.                      "SYSOP<ret>SYSOP<ret>"  it will be caught.   This allows 
  4185.                      "SYSOP<ret>  OF ARABIA<ret>" to be a name,  for example.  
  4186.                      Too eliminate both, use two lines: one with "SYSOP"  and 
  4187.                      one with "SYSOP SYSOP". 
  4188.  
  4189.                      If  you have "handles allowed"  toggled to on,  then  it 
  4190.                      really becomes an exact comparison,  since the  software 
  4191.                      does  not ask users for last names when  "handles"   are 
  4192.                      allowed. 
  4193.  
  4194.                 Comment file for ZIP/ARJ's
  4195.                      If this file exists, then it is automatically added into 
  4196.                      uploaded  ZIP  or  ARJ  files  as  the  archive  comment 
  4197.                      (replacing whatever one is there). 
  4198.  
  4199.                      The file should contain no ANSI codes.
  4200.                      
  4201.                      ARJ only uses the first 2048 bytes of the file.
  4202.  
  4203.                      There must be the defined minimum space for ZIP's,   and 
  4204.                      the  file's size + minimum space for ARJ's,  before  the 
  4205.                      software will do it. 
  4206.  
  4207.                      A  file  of  size zero will  simply  clear  out  archive 
  4208.                      comments. 
  4209.  
  4210.                      If  the pathname contains a wildcard,  then the software 
  4211.                      will  use  a randomly selected one of those  files  that 
  4212.                      match. 
  4213.  
  4214.                 Message downloading storage file
  4215.                      This  file  is  used  to  store  messages  for   message 
  4216.                      downloading with the ASCII and ANSI methods. 
  4217.  
  4218.                 Menu commands structure pathname
  4219.                      This file stores which menu commands are stored in which 
  4220.                      menu. 
  4221.  
  4222.                 Command categories pathname
  4223.                      This file stores which menu commands are stored in which 
  4224.                      category. 
  4225.  
  4226.                 Command definitions pathname
  4227.                      This file stores the functionality of each menu command. 
  4228.  
  4229.                 Menu commands definitions pathname
  4230.                      This  file  stores the parameters for each  menu's  menu 
  4231.                      commands. 
  4232.  
  4233.                 Special effects pathname
  4234.                      This  file  contains the special-effects strings  to  be 
  4235.                      displayed when menu commands are selected.  This file is 
  4236.                      a  standard  text  file and can be edited  whenever  you 
  4237.                      want. 
  4238.  
  4239.                 ┌──────────────────────────────────────────────────────────────────────────┐
  4240.                 │A.        Master List work pathnames:  C:\BBS\MASTER.LS                   │
  4241.                 │B.    Master List archive 1 pathname:  C:\BBS\MASTER.ZI1                  │
  4242.                 │C.    Master List archive 2 pathname:  C:\BBS\MASTER.ZI2                  │
  4243.                 │D.    Master List archive 3 pathname:  C:\BBS\MASTER.ZI3                  │
  4244.                 │E.    Master List archive 4 pathname:  C:\BBS\MASTER.ZI4                  │
  4245.                 │F.    Master List archive 5 pathname:  C:\BBS\MASTER.ZI5                  │
  4246.                 │G.    Master List archive 6 pathname:  C:\BBS\MASTER.ZI6                  │
  4247.                 │H.    Master List archive 7 pathname:  C:\BBS\MASTER.ZI7                  │
  4248.                 │I.    Master List archive 8 pathname:  C:\BBS\MASTER.ZI8                  │
  4249.                 │J.    Master List archive 9 pathname:  C:\BBS\MASTER.ZI9                  │
  4250.                 │K.   Master List before ZIP pathname:  C:\BBS\MASTER.LST                  │
  4251.                 │L.     Master List download pathname:  C:\BBS\MASTER.ZIP                  │
  4252.                 │M.   File comparing index 1 pathname:  C:\BBS\FILE1.IDX                   │
  4253.                 │N.   File comparing index 1 pathname:  C:\BBS\FILE2.IDX                   │
  4254.                 │O.  File comparing results pathnames:  C:\BBS\COMPFILE.                   │
  4255.                 │Q.       Pathname of BBS's logo ANSI:  C:\BBS\NODE.001\ANSI\LOGO.ANS      │
  4256.                 │                                                                          │
  4257.                 │Type letter to modify or [Enter] to continue:                             │
  4258.                 └──────────────────────────────────────────────────────────────────────────┘
  4259.  
  4260.                 Master List work pathnames
  4261.                      Temporary files for the up-to-9 Master List's. 
  4262.  
  4263.                 Master List archive 1 pathname
  4264.                 Master List archive 2 pathname
  4265.                 Master List archive 3 pathname
  4266.                 Master List archive 4 pathname
  4267.                 Master List archive 5 pathname
  4268.                 Master List archive 6 pathname
  4269.                 Master List archive 7 pathname
  4270.                 Master List archive 8 pathname
  4271.                 Master List archive 9 pathname
  4272.                      These are the Master List files.   Each ZIP represents a 
  4273.                      different file areas SL tier. 
  4274.  
  4275.                 Master List before ZIP pathname
  4276.                      This  is  the  name  of the Master  List  file  in  each 
  4277.                      MASTER.ZIx archive. 
  4278.  
  4279.                 Master List download pathname
  4280.                      This  is  the  name to change the  MASTER.ZIx  files  to 
  4281.                      before sending it to the caller. 
  4282.  
  4283.                 File comparing index 1 pathname
  4284.                      This  is a temporary file used in the comparison of  two 
  4285.                      file lists. 
  4286.                      
  4287.                 File comparing index 1 pathname
  4288.                      This  is a temporary file used in the comparison of  two 
  4289.                      file lists. 
  4290.  
  4291.                 File comparing results pathnames
  4292.                      This  file  contains the results of comparing  two  file 
  4293.                      lists. 
  4294.  
  4295.                 Pathname of BBS's logo ANSI
  4296.                      Pathname of your LOGO screen.   This is (only)  used for 
  4297.                      .QWK packets, to supply them with a "HELLO" ANSI. 
  4298.  
  4299.                      If  you  want your .QWK packets to contain  a  different 
  4300.                      ANSI, just use that name here instead. 
  4301.  
  4302.                 ┌──────────────────────────────────────────────────────────────────────────┐
  4303.                 │A.    ANSI to display for Msg DL'ing:  C:\BBS\NODE.???\ANSI\MSGDL.ANS     │
  4304.                 │B.Pathname to store archive comments:  C:\BBS\GLOBAL\TEXT\COMMENTS.OUT    │
  4305.                 │C.     EchoMail AREA: name re-mapper:  C:\BBS\GLOBAL\SYSTEM\ECHOS.DAT     │
  4306.                 │D.      Node lists database pathname:  C:\BBS\GLOBAL\SYSTEM\NODELIST.DAT  │
  4307.                 │E.         Node lists index pathname:  C:\BBS\GLOBAL\INDEXES\NODELIST.IDX │
  4308.                 │                                                                          │
  4309.                 │Type letter to modify or [Enter] to continue:                             │
  4310.                 └──────────────────────────────────────────────────────────────────────────┘
  4311.  
  4312.                 ANSI to display for Msg DL'ing
  4313.                      This  is  the ANSI you wish to display for the  "Message 
  4314.                      Downloader" menu. 
  4315.  
  4316.                 Pathname to store archive comments
  4317.                      This is the file to which you wish to put extracted .ZIP 
  4318.                      header comments. 
  4319.  
  4320.                 EchoMail AREA: name re-mapper
  4321.                      This  is the data file for re-mapping incoming  EchoMail 
  4322.                      conference names to your own areas. 
  4323.  
  4324.                 Node lists database pathname
  4325.                      This  is the data file containing the pathnames  of  the 
  4326.                      node lists you wish to the software to use. 
  4327.  
  4328.                 Node lists index pathname
  4329.                      This  is  an index file created that contains  the  node 
  4330.                      addresses  and their location from each of the node list 
  4331.                      files you wish to be part of your BBS. 
  4332.  
  4333.                 Except for "Ram Drive",  all path and file name entries  also 
  4334.                 are in use immediately  after  the  change.    If this causes 
  4335.                 problems,   then  you should bridge the old and new  name  by 
  4336.                 first  copying  the  old file to the new  name,   change  the 
  4337.                 settings name, then delete the old file. 
  4338.  
  4339.  
  4340. CONVERSION      Some advice on converting from another BBS program:
  4341.                 
  4342.                 Use   the   Import  Descriptions  command  to  convert   file 
  4343.                 descriptions. 
  4344.  
  4345.                 ANSI's should not be any problems,  although you will have to 
  4346.                 match  your  menu commands with my functions.   It is best to 
  4347.                 phase this in one or two commands at a time. 
  4348.  
  4349.                 If you are currently using RemoteAccess,  Telegard, Renegade, 
  4350.                 or  SpitFire,   then you can convert your users and  messages 
  4351.                 files  with  CONVERT.EXE.   If you are using something  else, 
  4352.                 then use this program  as  an example,  and modify it to suit 
  4353.                 your current BBS's data structures.   The program is entirely 
  4354.                 self-contained in standard DOS Basic.  If you need help, just 
  4355.                 ask  me,   chances are I will do it for you.    If  you  make 
  4356.                 changes,   send  me  them so that others may  benefit.    The 
  4357.                 convert  program  has not undergone a lot of  testing--if  it 
  4358.                 does not work, tell me and I will give you a fixed version. 
  4359.                 
  4360.                 Telegard  and  RemoteAccess seem to have a lot  BBS  programs 
  4361.                 that use the same format (are rip-off's  of these rip-off's), 
  4362.                 they may be convertible as well.   For some others,  it might 
  4363.                 be  useful  to  use  an  intermediary  conversion  step  (for 
  4364.                 example, WWIV to RA to JDR_BBS). 
  4365.  
  4366.  
  4367. MODEM SETUP     You  should  make  sure to switch  your  modem's  auto-answer 
  4368.                 feature  off.   Whether it requires a hardware switch,   or a 
  4369.                 software switch, depends on your make. 
  4370.  
  4371.                 You must have a fossil driver installed.   There are two that 
  4372.                 I know of:  X00 and BNU.  "Fossil"  is the common terminology 
  4373.                 for  this type of program,  it actually is a  "Communications 
  4374.                 API".  API  (Application Programming Interface)  is a word we 
  4375.                 will  be  hearing  a  lot  of in the  90's.    DSZ  could  be 
  4376.                 considered   a  protocol  API.    They  all  serve  to   make 
  4377.                 programming a lot easier. 
  4378.  
  4379.                 There are three "musts" you modem must be able to do:
  4380.                   It must return "CONNECT xxxxxx" lines.  Where "xxxx" is the 
  4381.                   caller's baud rate. 
  4382.                   It must have a "CR/LF" after each line it sends.
  4383.                   It must be able to hang up when DTR is lowered.
  4384.                 Normally, most modems do the above (certainly any new ones).
  4385.  
  4386.                 Your modem should be configured as such:
  4387.                   Modem echos data (usually E1).
  4388.                   Modem sound off (usually M0).
  4389.                   Result codes displayed (usually Q0).
  4390.                   Full result codes (usually X4).
  4391.                   Verbal result codes (usually V1).
  4392.                   Auto-answer off (usually S0=0).
  4393.                   DTR follows connection (usually &D1).
  4394.                   Carrier-Detect (CD/DCD) follows connection (usually &C1).
  4395.                 
  4396.                 So,   usually ATE1M0Q0X4V1S0=0  will do it.   However,   some 
  4397.                 modems need an &C1, &D1, or other commands.  If you find that 
  4398.                 your  modem  is  staying off hook (such as  after  you  logon 
  4399.                 locally)   add  an  H0   (hang up  phone)   command  to  your 
  4400.                 initialization string. 
  4401.  
  4402.                 If you are confused, then do not change what I have.  ATZ for 
  4403.                 the initialization string usually works with any modem.
  4404.  
  4405.                 For  some commands,  the computer goes into an infinite  loop 
  4406.                 (locks up)  when you specify a port for which you do not have 
  4407.                 a modem.   Also,  it may lock up if  you  have configured the 
  4408.                 fossil wrong (particularly  if you specified a baud rate your 
  4409.                 modem cannot handle,  since all your modem see's is gibberish 
  4410.                 when the fossil try's to talk to it). 
  4411.  
  4412.                 The  CONNECT  strings database is divided into three  fields: 
  4413.                 The CONNECT  strings modems send,  the maximum CPS rate  that 
  4414.                 that  connection yields, and what to show for that connection 
  4415.                 when a user downloads files. 
  4416.  
  4417.                 When a call comes into the software,  the database is scanned 
  4418.                 for a string that matches what the modem sends.   If none  is 
  4419.                 found,  then the phone is hung up, and a "non-user"  log note 
  4420.                 is made. 
  4421.  
  4422.                 The following is a checklist for setting up your modem:
  4423.                   1. Do the X00 command set up.
  4424.                   2. Put your correct initialization commands in LINES.TXT.
  4425.                   3. Make sure the CONNECT strings database has every connect 
  4426.                      string  your modem can send (that is,  those you want to 
  4427.                      allow). 
  4428.                   4. Change the communications port to that of your modem  in 
  4429.                      Settings. 
  4430.  
  4431.                 <alt>s (shelling to DOS)  and local logon takes the phone off 
  4432.                 the hook.   <alt>x (exit to dos)  does not take the phone off 
  4433.                 the hook. 
  4434.  
  4435.                 For  dialing,   I  assume ATDT,  but you can change  this  in 
  4436.                 SHORT.TXT.  Search for "dt" and "dt1-".
  4437.  
  4438.                 LINES.TXT lines 625  to 628 contains the commands sent to the 
  4439.                 modem to do various things. 
  4440.  
  4441.                 The  modem  will show you what it is  sending  and  receiving 
  4442.                 while  trying  to initialize the modem (and when  dialing  or 
  4443.                 receiving  a call).   If it fails to initialize,  then it  is 
  4444.                 usually  due  to  you  setting up the fossil  or  your  modem 
  4445.                 initialization string wrong. 
  4446.  
  4447.                 Be  sure  you set your baud rate in Change  Settings  to  the 
  4448.                 maximum your modem can handle. 
  4449.  
  4450.                 See also: LINES.TXT, APPENDIX J, SETTINGS, CONFIG
  4451.  
  4452. Problems        If  you find that when calling your BBS the keys you type  at 
  4453.                 menu's  are not immediately responded too--some more text  is 
  4454.                 sent before it responds--then you should make sure your modem 
  4455.                 is configured for it's smallest possible internal  buffering.  
  4456.                 That  is,  rather than let the modem's hardware do buffering, 
  4457.                 we want to let the fossil handle buffering. 
  4458.                 
  4459.                 For  modem/connection  problems  when just  getting  started, 
  4460.                 there are two steps: 
  4461.  
  4462.                 The first involves <alt>d from the waiting-for-caller screen.  
  4463.                 If you are able to enter a "H0",  and the modem responds with 
  4464.                 "OK" when it sends ATH0.  When you get an "OK", you know that 
  4465.                 the fossil driver and modem initialization setup is,  for the 
  4466.                 most part,  correct.  If you do not get an "OK",  to "H0"  or 
  4467.                 any  other valid command,  then either the fossil is  set  up 
  4468.                 wrong, or the modem initialization string is wrong. 
  4469.  
  4470.                 The  next  solution,  usually for figuring out  more  complex 
  4471.                 problems,   is the <alt>p command from the waiting-for-caller 
  4472.                 screen.  Whereas <alt>d is a one-shot-at-a-time modem sender, 
  4473.                 this  command  puts  you  in  continuous  command  mode.   So 
  4474.                 everything   you  type  goes  directly  to  the  modem,   and 
  4475.                 everything the modem receives you see directly.  Exactly like 
  4476.                 the  command  mode of  any  communications/terminal  program.  
  4477.                 <alt>p relies on your Settings baud rate. 
  4478.  
  4479.                 Remember the 3 modem status buttons at the waiting-for-caller 
  4480.                 screen:  CTS, DSR, DCD.   CTS probably does not matter.   But 
  4481.                 DSR and DCD should be in the "up"  position when no caller is 
  4482.                 trying to call.  And should go "down" before you start seeing 
  4483.                 the information that the modem is receiving (CONNECT string). 
  4484.                 If  this is not occurring,  you should make sure  your  modem 
  4485.                 initialization string, and maybe your hang up string, produce 
  4486.                 these results. 
  4487.                 
  4488.                 
  4489. TERMINAL        See  the <alt>d command information in  CONSOLE  KEYS.
  4490. PROGRAM         
  4491.                 <alt>d enters the terminal program.   You are given a  simple 
  4492.                 "do what"  question.  You may either choose to send a command 
  4493.                 to the modem directly, use the "d" and "c" commands. 
  4494.  
  4495.                 "dt xxx-yyy-zzzz" would be to call another computer. 
  4496.                 
  4497.                 "d" alone will access your Sysops database. 
  4498.  
  4499.                 "d xxxx"  will dial the number of the Sysops  database  entry 
  4500.                 that  contains the string "xxxx"  in any of its fields.    If 
  4501.                 more than one entry contains the string, you will be asked to 
  4502.                 select which entry to call. 
  4503.  
  4504.                 "c  xxxx"  works like "d xxxx"  but instead of one attempt it 
  4505.                 will make continuous attempts. 
  4506.  
  4507.                 Type "?" for the available commands.
  4508.  
  4509.                 When you have contacted another BBS,  the following  keys are 
  4510.                 active: 
  4511.  
  4512.                 <f1>       toggles the trapping of all comm I/O to a file.
  4513.                 <f2>       Send a file (ASCII send--no protocols).    Can use 
  4514.                            wildcards  to  send a random file from a bunch  of 
  4515.                            files.  No stop/exit key handling is done. 
  4516.                 <pgup>     to send a file.   You must enter the full path and 
  4517.                            filename  of the file(s)  to upload--wildcards are 
  4518.                            OK. 
  4519.                 <pgdn>     to  receive a file.   After starting the  transfer 
  4520.                            just hit <pgdn>.
  4521.                 <end>      to transmit any net mail meant for that BBS.    If 
  4522.                            you  did not dial with "d string"  or  "c  string" 
  4523.                            then  it  will ask you which net address to  use--
  4524.                            otherwise it uses the net address for that  sysops 
  4525.                            database  entry.    Once hit,  there is no way  to 
  4526.                            abort  <end>--since the other BBS will now  accept 
  4527.                            nothing less than a mail attempt. 
  4528.                 <alt>h     to hang up.
  4529. │               <alt>l     to  "turn the tables".   This allows the sysop  on 
  4530. │                          the  other end to log into your BBS as if it  were 
  4531. │                          they who called you.   If using JDR_BBS, then that 
  4532. │                          sysop  must be in <alt>p mode.   If using  another 
  4533. │                          BBS program,  then they must be in a "pure mode"--
  4534. │                          that  is,  where they accept everything that comes 
  4535. │                          in,  and do not send ANSI codes back out (example, 
  4536. │                          chat is not a "pure mode",  when it changes colors 
  4537. │                          depending on who is "talking".). 
  4538.                 <alt>s     to shell to DOS.   From the shell, you may execute 
  4539.                            a different protocol,   or use something like LIST 
  4540.                            to   examine  the  trapping  file  (if  you   were 
  4541.                            trapping). 
  4542.                 <c><left>  <control><left> This will send an ASCII 27.  It is 
  4543.                            expected  that you will follow up this key with  a 
  4544.                            valid   ANSI   string--none  of  which   will   be 
  4545.                            displayed. 
  4546.  
  4547. │               The  arrow keys will send out the appropriate ANSI codes  for 
  4548. │               arrow key movements. 
  4549.                 
  4550.                 I am not sure if this is unique to having an HST:  but when I 
  4551.                 call 2400 baud BBS's, their initially sent information is not 
  4552.                 shown,  and I have to hit [Enter] (which tells the called BBS 
  4553.                 to  re-ask its last question or to move onto the next  ANSI).  
  4554.                 This is not a problem at MNP connects. 
  4555.                 
  4556.                 On  some BBS's,  you will be able to use <Control>S to pause, 
  4557.                 and <Control>Q  to  un-pause  (note,  you  may  have  to  hit 
  4558.                 <Control>Q twice. 
  4559.  
  4560.                 Unfortunately,   one  of  the most useful  abilities  of most 
  4561.                 communications programs is missing:  the backscroll buffer. I 
  4562.                 do plan to add this. 
  4563.  
  4564.                 If the BBS you call has Avatar display codes,  you can toggle 
  4565.                 it to ON on that BBS.  No toggle is needed on this end as the 
  4566.                 software looks for ANSI and Avatar codes all the time. 
  4567.  
  4568.                 High-speed  modems  usually  have large  buffers.    A   slow 
  4569.                 computer  can  lead to situation in which the buffer  can  be 
  4570.                 filled faster  than the characters are  written to the screen 
  4571.                 (especially so if you have trap ON).  To get around this, the 
  4572.                 software  clears  this  input buffer every time  you  type  a 
  4573.                 character.   It should not cause any troubles--it should  not 
  4574.                 even  be noticed--but if it does,  let me know.   The  faster 
  4575.                 your computer and modem, the larger your receive buffer ("R=" 
  4576.                 in fossil initialization string) should be. 
  4577.  
  4578.                 When  calling another number,  if all you get  is  RINGING's, 
  4579.                 then after you hit a key to abort the process,  enter an "H0" 
  4580.                 for the command string to hang up the phone. 
  4581.  
  4582.  
  4583. SPECIAL THANKS  To  the users of Immortality--who have been putting  up  with 
  4584.                 oft-times  flaky software and a non-attentive sysop  for  two  
  4585.                 years now as I have developed this software. 
  4586.  
  4587.  
  4588. NEXT            DOCS_2 should be your next stop.
  4589.  
  4590.